Skip to content

VitePress 时间线插件

vitepress-markdown-timeline 插件让你可以在 VitePress 中使用 markdown 语法,并将其渲染为时间线(时间轴)样式。

安装

sh
$ npm install vitepress-markdown-timeline
sh
$ pnpm add vitepress-markdown-timeline
sh
$ yarn add vitepress-markdown-timeline

引入

先在 .vitepress/config.js 中注册 markdown 解析插件:

.vitepress/config.js
js
import timeline from 'vitepress-markdown-timeline'

export default {
  markdown: {
    config: md => {
      md.use(timeline)
    }
  }
}

然后在 .vitepress/theme/index.js 中引入时间线样式:

.vitepress/theme/index.js
js
import Theme from 'vitepress/theme'
import 'vitepress-markdown-timeline/dist/theme/index.css'

export default Theme

使用

在 markdown 文件中以 ::: timeline 时间 开头,并以 ::: 结尾,中间插入内容即可(内容中可使用任何 markdown 语法)。

  • 输入

    md
    ::: timeline 2023-05-24
    
    - **do some thing1**
    - do some thing2
      :::
    
    ::: timeline 2023-05-23
    do some thing3
    do some thing4
    :::
  • 输出

    2023-05-24
    • do some thing1
    • do some thing2
    2023-05-23

    do some thing3 do some thing4