语法主题

更新于 2026年11月12日

Livemark 使用 Shiki 为围栏代码块提供语法高亮。每个主题都有两种风格：在浅色背景下启用的浅色主题，以及在深色背景下启用的深色主题。系统会根据访问者的主题偏好自动选择合适的一种。

配置

import { defineConfig } from "livemark"

export default defineConfig({
  include: "docs/**/*.md",
  codeThemeLight: "github-light",
  codeThemeDark: "github-dark",
})

任何 Shiki 内置主题名 都可以使用。

常用搭配

• github-light / github-dark
• catppuccin-latte / catppuccin-mocha（默认）
• min-light / min-dark
• vitesse-light / vitesse-dark
• one-light / one-dark-pro

关于无障碍

Livemark 默认对 catppuccin-latte 做了一处细微的颜色修正：该主题默认的字符串绿色（#40a02b）在其背景上的对比度为 3.2:1，低于 WCAG AA 标准（4.5:1）。Livemark 会在构建时将其替换为 #2a7e16。

如果你使用自己的主题并希望符合 AA 标准，请在发布前用对比度工具检查每个 token 颜色与代码块背景的对比度。正常字号文本需要达到的阈值是 4.5:1。

另请参阅

• 代码块：编写方面的内容，包括 meta 字符串、diff、行高亮。
• 覆盖（escape）：如需更深入的控制，可覆盖整个代码块组件。