mirror of
https://github.com/mermaid-js/mermaid.git
synced 2025-09-17 22:39:56 +02:00
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# Configuration
|
|
|
|
When mermaid starts, configuration is extracted to determine a configuration to be used for a diagram. There are 3 sources for configuration:
|
|
|
|
- The default configuration
|
|
- Overrides at the site level are set by the initialize call, and will be applied to all diagrams in the site/app. The term for this is the **siteConfig**.
|
|
- Frontmatter (v10.5.0+) - diagram authors can update selected configuration parameters in the frontmatter of the diagram. These are applied to the render config.
|
|
- Directives (Deprecated by Frontmatter) - diagram authors can update selected configuration parameters directly in the diagram code via directives. These are applied to the render config.
|
|
|
|
**The render config** is configuration that is used when rendering by applying these configurations.
|
|
|
|
## Frontmatter config
|
|
|
|
The entire mermaid configuration (except the secure configs) can be overridden by the diagram author in the frontmatter of the diagram. The frontmatter is a YAML block at the top of the diagram.
|
|
|
|
```mermaid-example
|
|
---
|
|
title: Hello Title
|
|
config:
|
|
theme: base
|
|
themeVariables:
|
|
primaryColor: "#00ff00"
|
|
---
|
|
flowchart
|
|
Hello --> World
|
|
|
|
```
|
|
|
|
## Theme configuration
|
|
|
|
## Starting mermaid
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
Site->>mermaid: initialize
|
|
Site->>mermaid: content loaded
|
|
mermaid->>mermaidAPI: init
|
|
```
|
|
|
|
## Initialize
|
|
|
|
The initialize call is applied **only once**. It is called by the site integrator in order to override the default configuration at a site level.
|
|
|
|
## configApi.reset
|
|
|
|
This method resets the configuration for a diagram to the overall site configuration, which is the configuration provided by the site integrator. Before each rendering of a diagram, reset is called at the very beginning.
|