Docusaurus Markdown

备注

这里汇总我使用的一些常用格式,以备参考

完整请参考官方文档

链接

有两种方式链接到其他页面:

  • URL path: [URL path to another document](./installation)

  • file path: [file path to another document](./installation.mdx)

代码块

  • 代码块案例,以 bash 为例

代码块案例
```bash
zpool create -f -o ashift=12 zdata /dev/diskid/DISK-Y39B70RTK7ASp4 \
/dev/diskid/DISK-54UA4062K7ASp2 \
/dev/diskid/DISK-X4GA30KZKQJPp2 \
/dev/diskid/DISK-54UA4072K7ASp2
```

这里的代码块方法和GitHub相同,但是需要注意Docusaurus默认只支持部分常用语言,并没有包含 bash / ruby 之类,所以需要修订配置

  • 修改 docusaurus.config.js 添加 prism 的支持语言类型:

修订 docusaurus.config.js 添加 prism 的支持语言类型
...
      prism: {
        theme: prismThemes.github,
        darkTheme: prismThemes.dracula,
        additionalLanguages: ['bash', 'ruby' ],
      },
...