Skip to content

CSS 变量手册 ​

Obsidian 暴露了大量 CSS 变量,主题与插件样式应优先引用它们,才能随明暗模式自动适配。

核心要点 ​

分类变量 ​

  • 颜色:--background-primary / --background-secondary / --text-normal / --text-muted / --interactive-accent
  • 字体:--font-text / --font-ui / --font-monospace
  • 尺寸:--font-text-size / --line-height / --file-line-width
  • 圆角/阴影:--radius-s/m/l / --shadow-s/m/l
  • Callout:--callout-color / --callout-icon(1.13 起颜色用 OKLCH / CSS 颜色值)

使用建议 ​

css
.my-el {
  background: var(--background-secondary);
  color: var(--text-normal);
  border-radius: var(--radius-s);
}
  • 切勿硬编码 #fff,否则暗色模式下不可读
  • 1.13 起 --callout-color 格式变更为 OKLCH,旧 HEX 写法需迁移

调试技巧 ​

相关阅读 ​