diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index 3e5ca25f..101437ae 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -1,8 +1,10 @@
 import starlight from "@astrojs/starlight";
 import { defineConfig } from "astro/config";
+import remarkGfm from "remark-gfm";
 
 export default defineConfig({
   site: "https://cli.archgate.dev",
+  markdown: { remarkPlugins: [remarkGfm] },
   integrations: [
     starlight({
       title: "Archgate",
diff --git a/docs/bun.lock b/docs/bun.lock
index f2f355de..faf6a986 100644
--- a/docs/bun.lock
+++ b/docs/bun.lock
@@ -8,6 +8,7 @@
         "@astrojs/starlight": "^0.39.0",
         "astro": "^6.0.0",
         "posthog-js": "^1.368.2",
+        "remark-gfm": "^4.0.1",
         "sharp": "^0.34.1",
       },
     },
diff --git a/docs/package.json b/docs/package.json
index 55149dcc..e4b23d32 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -11,6 +11,7 @@
     "@astrojs/starlight": "^0.39.0",
     "astro": "^6.0.0",
     "posthog-js": "^1.368.2",
+    "remark-gfm": "^4.0.1",
     "sharp": "^0.34.1"
   }
 }