跳转到内容

Steps

步骤容器插件,用于在 Markdown 中创建步骤引导内容。

安装

sh
pnpm add vitepress-plugin-steps
sh
npm install vitepress-plugin-steps
sh
bun add vitepress-plugin-steps
sh
deno add vitepress-plugin-steps
sh
yarn add vitepress-plugin-steps

使用

vitepress-tuck 模式 推荐

.vitepress/config.ts
ts
import { defineConfig } from 'vitepress-tuck'
import steps from 'vitepress-plugin-steps'

export default defineConfig({
  plugins: [steps()],
})

查看 vitepress-tuck 了解更多

传统模式

.vitepress/config.ts
ts
import { defineConfig } from 'vitepress'
import { stepsMarkdownPlugin } from 'vitepress-plugin-steps'

export default defineConfig({
  markdown: {
    config: (md) => {
      md.use(stepsMarkdownPlugin)
    },
  },
})

同时在主题中引入样式:

.vitepress/theme/index.ts
ts
import 'vitepress-plugin-steps/style.css'

语法

使用 ::: steps 容器包裹步骤内容,每个步骤以无序/有序列表项开头:

md
::: steps

- 第一步

  第一步的描述内容

- 第二步

  第二步的描述内容

- 第三步

  第三步的描述内容,支持标题语法

:::

渲染结果:

  • 第一步

    第一步的描述内容

  • 第二步

    第二步的描述内容

  • 第三步

    第三步的描述内容,支持标题语法

基于 MIT 许可发布