Diagrams
Diagrams can be rendered using Mermaid in a code block.
Installation
- npm
- Yarn
- pnpm
npm install --save @docusaurus/theme-mermaid
yarn add @docusaurus/theme-mermaid
pnpm add @docusaurus/theme-mermaid
Enable Mermaid functionality by adding plugin @docusaurus/theme-mermaid
and setting markdown.mermaid
to true
in your docusaurus.config.js
.
docusaurus.config.js
module.exports = {
markdown: {
mermaid: true,
},
themes: ['@docusaurus/theme-mermaid'],
};
Usage
Add a code block with language mermaid
:
Example Mermaid diagram
```mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
```
See the Mermaid syntax documentation for more information on the Mermaid syntax.
Theming
The diagram dark and light themes can be changed by setting mermaid.theme
values in the themeConfig
in your docusaurus.config.js
. 你可以同时为亮色和暗色模式指定图表的主题。
docusaurus.config.js
module.exports = {
themeConfig: {
mermaid: {
theme: {light: 'neutral', dark: 'forest'},
},
},
};
See the Mermaid theme documentation for more information on theming Mermaid diagrams.
Mermaid Config
Options in mermaid.options
will be passed directly to mermaid.initialize
:
docusaurus.config.js
module.exports = {
themeConfig: {
mermaid: {
options: {
maxTextSize: 50,
},
},
},
};
See the Mermaid configuration documentation for the available config options.