代码高亮
概述
主题内置的代码高亮插件， 对代码块进行代码高亮。
主题 使用 Shiki 在 Markdown 代码块中使用彩色文本实现语法高亮。 Shiki 支持多种编程语言。
在 Shiki 的代码仓库中，可以找到 合法的编程语言列表 。
特性
配置
默认配置：
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
codeHighlighter: {
themes: { light: 'vitesse-light', dark: 'vitesse-dark' },
notationDiff: true,
notationErrorLevel: true,
notationFocus: true,
notationHighlight: true,
notationWordHighlight: true,
highlightLines: true,
collapsedLines: false,
lineNumbers: true,
},
}),
})关于配置入口的优先级说明，请参考 插件配置入口。
themes
- 类型:
{ light: string, dark: string } - 默认值:
{ light: 'vitesse-light', dark: 'vitesse-dark' }
代码高亮主题，支持 浅色/暗色 双主题。
可在 支持的 主题列表 中选择你喜欢的主题。
langs
- 类型:
string[] - 默认值:
[]
需要高亮的编程语言， 例如 javascript、typescript、python、java、c++、c#等。 默认会根据代码块的语言自动识别。
在 Shiki 的代码仓库中，可以找到 合法的编程语言列表 。
defaultLang
- 类型：
string - 默认值：
text
指定的语言不可用时所使用的备选语言。
lineNumbers
- 类型：
boolean | number - 默认值：
true
是否显示行号。
true： 显示行号false： 不显示行号number： 指定需要显式代码行号的最小行数。
twoslash
- 类型:
boolean | ShikiTwoslashOptions - 默认值:
false
是否启用 对 typescript 和 vue 语言的 类型提示 支持。
whitespace
- 类型:
boolean | 'all' | 'boundary' | 'trailing' - 默认值:
false
将空白字符（Tab 和空格）渲染为单独的标签（具有 tab 或 space 类名）。
效果：
<catalog>
<book>
<title>Everyday Italian</title>
</book>
</catalog>collapsedLines
- 类型:
boolean | number - 默认值：
false
将代码块折叠到指定行数。
renderIndentGuides
- 类型:
boolean | Partial<TransformerRenderIndentGuidesOptions> - 默认值:
false
是否在代码块中渲染缩进参考线。启用后，代码中的缩进会显示为可视化的参考线，便于阅读嵌套较深的代码。
colorizedBrackets
- 类型:
boolean | Partial<TransformerColorizedBracketsOptions> - 默认值:
false
是否为代码块中的括号添加颜色匹配。启用后，成对的括号会以不同颜色显示，便于识别代码中的括号匹配关系。
transformers
- 类型:
ShikiTransformer[] - 默认值:
[]
代码转换器， 查看 shiki transformers 了解更多信息。
