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

第24章 配置 Transformers

配置 Transformers ​ 环境:node 该 setup 函数只在 Node.js 环境下运行,可以使用 Node 的 API。

这个 setup 函数允许你为每张幻灯片的 Markdown 内容定义自定义 transformer。当你想添加自定义 Markdown 语法、渲染自定义代码块时,这个功能会非常有用。

首先创建一个 `./setup/transformers.ts` 文件,内容如下:setup/transformers.tstsimport { defineCodeblockTransformer, defineMarkdownTransformer, defineTransformersSetup } from '@slidev/types' import lz from 'lz-string'

const mySyntax = defineMarkdownTransformer((ctx) => { console.log('index in presentation', ctx.slide.index) ctx.s.replace( /^\[\[\[(.*)\]\]\]/gm, (full, content) => { return `...` }, ) })

const myCodeblock = defineCodeblockTransformer((ctx) => { if (ctx.info.startsWith('myblock')) { console.log('index in presentation', ctx.slide?.index) return `` } })

export default defineTransformersSetup(() => { return { // 在 Markdown 解析前应用,针对每张幻灯片 pre: [mySyntax], // 针对每个 Markdown 代码块应用 codeblocks: [myCodeblock], } })NOTE如果可以的话,建议将 pre transformer 实现为 markdown-it 插件,这样更稳健。

评论 (0)