进阶 sli.dev 2026-11-21 18:58:32 · 1 阅读

第20章 配置代码高亮

第20章 配置代码高亮

Slidev 使用 Shiki 作为代码高亮工具。它是一个基于 TextMate Grammar 的语法高亮器,准确度和 VS Code 相当。它会直接生成带颜色的 token,因此不需要额外的 CSS。Shiki 还内置了大量主题。在 Slidev 中,我们还提供了 TwoSlash 支持。

配置 Shiki

Environment: both

这个 setup 函数会同时在 Node.js 和客户端运行,请避免使用 Node.js 或 DOM API,以免出现运行时错误。

创建 ./setup/shiki.ts 文件,内容如下:

setup/shiki.ts

```ts import { defineShikiSetup } from '@slidev/types'

export default defineShikiSetup(() => { return { themes: { dark: 'min-dark', light: 'min-light', }, transformers: [ // ... ], } }) ```

如果你想添加自定义主题或语言(JSON 格式的 TextMate grammar/themes),可以在 setup 文件中导入:

setup/shiki.ts

```ts import { defineShikiSetup } from '@slidev/types' import customLanguage from './customLanguage.tmLanguage.json' import customTheme from './customTheme.tmTheme.json'

export default defineShikiSetup(() => { return { themes: { dark: customTheme, light: 'min-light', }, langs: [ 'js', 'typescript', 'cpp', customLanguage, // ... ], transformers: [ // ... ], } }) ```

查看内置语言和内置主题,更多细节请参考 Shiki 的文档。

INFO

目前 Shiki Magic Move 还不支持 transformers。

配置 Prism

WARNING

自 v0.50 起,Prism 支持已被移除,请改用 Shiki。

评论 (0)