docmd 采用 CSS 变量优先架构。这意味着只需在 :root 块中覆盖少数几个变量,无需编写复杂的 CSS 选择器,即可重新设计整个网站的样式。

全局变量参考

变量 亮色模式默认值 暗色模式默认值 说明
--bg-color #ffffff #09090b 页面主背景色
--text-color #3f3f46 #a1a1aa 正文文本颜色
--text-heading #09090b #fafafa 标题与页眉颜色
--link-color #068ad5 #068ad5 主色调 / 链接颜色
--border-color #e4e4e7 #27272a 分割线与边框颜色
--sidebar-bg #fafafa #09090b 导航背景色
--ui-border-radius 6px 6px 所有 UI 项的圆角大小
--sidebar-width 260px 260px 侧边栏列宽

覆盖示例

如需更改网站主色调,请将以下内容添加到 customCss 文件中:

:root {
  --link-color: #f43f5e; /* Rose 500 */
}

body[data-theme="dark"] {
  --link-color: #fb7185; /* Rose 400 */
}

组件定向覆盖

如需对特定组件进行样式化,可使用以下顶级类名:

  • .main-content:所有 Markdown 内容的包裹容器。
  • .sidebar-nav:内部导航列表。
  • .page-header:顶部导航栏。
  • .docmd-search-modal:搜索弹框。
  • .docmd-tabs:标签组件容器。
  • .callout:提示/备注框。

优先级排查

大多数 docmd 样式的优先级较低。如果覆盖未生效,请确认 customCss 是否已正确注册,并尝试在选择器前增加 body 前缀(如 body .main-content)。

由于 docmd 使用标准 CSS 变量,你可以直接询问 AI:“为 docmd 的 --link-color 和 --bg-color 提供一套专业配色方案”。模型将给出即用型 CSS,完美兼容内置主题。