Typora中使用Mermaid语法生成图时，如何实时预览图表？

Question

在Typora中使用Mermaid语法生成图表时，如何实现实时预览是一个常见问题。默认情况下，Typora可能不会立即渲染Mermaid图表。解决方法是：首先确保已启用“即时渲染”功能，进入偏好设置- Markdown扩展语法，勾选“即时渲染”。其次，安装支持Mermaid的第三方插件或依赖，如通过npm全局安装mermaid-cli（mmdc）。然后，在Markdown文件头部添加配置代码块，指定使用的Mermaid版本。保存文件后，Typora会自动识别并渲染Mermaid语法为图表。如果仍无法实时预览，尝试重启Typora或更新至最新版本。注意，部分系统环境可能需额外配置路径或变量才能正常工作。

Answer 1

1. 问题概述

在Typora中使用Mermaid语法生成图表时，实时预览功能可能无法正常工作。这一问题主要源于Typora默认配置不支持即时渲染Mermaid图表，同时需要额外安装相关依赖和插件。

• 常见现象：Markdown文件中的Mermaid代码块未被渲染为图表。
• 目标：实现Mermaid图表的实时预览。

2. 基础配置检查

首先，确保Typora的基础设置正确：

1. 打开Typora，进入“偏好设置”。
2. 导航至“Markdown扩展语法”选项卡。
3. 勾选“即时渲染”功能。

完成上述步骤后，保存设置并重新加载Typora以确认更改生效。

3. 安装依赖与工具

为了支持Mermaid图表的渲染，需要安装必要的工具：

npm install -g mermaid-cli

上述命令用于全局安装mermaid-cli（mmdc），这是一个强大的命令行工具，用于将Mermaid代码转换为图像。

部分系统环境可能需要额外配置环境变量或路径。例如，在Windows系统中，需确保Node.js已正确安装，并将npm全局模块路径添加到系统PATH中。

4. 配置Markdown文件

在Markdown文件头部添加如下配置代码块，指定使用的Mermaid版本：

<!-- markdown-config: {"mermaid": "8.14.0"} -->

保存文件后，Typora会自动识别Mermaid语法并尝试渲染图表。

5. 故障排查与优化

如果仍然无法实现实时预览，可以按照以下步骤排查问题：

步骤	操作
1	重启Typora，确保所有更改生效。
2	更新Typora至最新版本。
3	验证mermaid-cli是否正确安装，运行`mmdc -v`检查版本号。

通过上述方法，大多数问题可以得到有效解决。

6. 流程图示例

以下是使用Mermaid语法创建的一个简单流程图示例：

```mermaid
graph TD;
    A[问题] --> B{基础配置检查};
    B -->|是| C[安装依赖];
    B -->|否| D[排查问题];
    C --> E[配置Markdown文件];
    E --> F[完成];
```

此流程图展示了从发现问题到解决问题的完整路径。