diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 95695731..7d2ce701 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -56,6 +56,10 @@ export default extendConfig(
   withMermaid(
     defineConfig({
       markdown: {
+        theme: {
+          light: "github-light",
+          dark: "github-dark",
+        },
         config(md) {
           md.use(tabsMarkdownPlugin);
         },
diff --git a/docs/.vitepress/theme/styles.css b/docs/.vitepress/theme/styles.css
index 77209c07..5315de99 100644
--- a/docs/.vitepress/theme/styles.css
+++ b/docs/.vitepress/theme/styles.css
@@ -97,6 +97,11 @@ html:not(.dark):not([data-theme="dark"]) {
   --color-plane-500: #006399;
   --color-plane-600: #005280;
 
+  /* Inline code — neutral body-text color instead of the VitePress default
+     (brand blue), which is hard to read on the dark pill background.
+     Linked code keeps --vp-code-link-color (brand) so links stay visible. */
+  --vp-code-color: var(--vp-c-text-1);
+
   --docs-divider: #ececec;
 
   --vp-c-bg: #ffffff;
@@ -158,7 +163,7 @@ html:not(.dark):not([data-theme="dark"]) {
 :root[data-variant="voidzero"]:not(.dark):not([data-theme="dark"]),
 :root[data-variant="vitest"]:not(.dark):not([data-theme="dark"]) {
   --color-brand: #006399;
-  --vp-code-color: #006399;
+  --vp-code-color: var(--vp-c-text-1);
 }
 
 /* --- Dark mode --- */