在生成GitLab Wiki的Quarto文档中嵌入Mermaid图遇转义问题求助
解决Quarto生成GFM时Mermaid箭头转义导致GitLab Wiki无法渲染的问题
问题
通过Quarto生成包含Mermaid流程图的GitLab Wiki页面时,生成的Markdown文件中Mermaid代码里的箭头-->被转义为-->,导致GitLab无法正常渲染该流程图。
复现步骤
- Quarto源文件(test-gfm-mermaid.qmd):
--- title: "test gfm mermaid" format: gfm --- Text ```{mermaid} flowchart LR A-->B
2. 执行渲染命令: ```bash quarto render test-gfm-mermaid.qmd
- 生成的Markdown文件中,Mermaid代码段被转义:
# test gfm mermaid Text ``` mermaid flowchart LR A-->B
## 版本信息
[✓] Checking versions of quarto binary dependencies...
Pandoc version 3.1.1: OK
Dart Sass version 1.55.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
Version: 1.3.450
Path: /opt/quarto/bin
[✓] Checking basic markdown render....OK
## 解决方案 在Quarto的格式配置中添加Pandoc参数,禁止对代码块内的特殊字符进行转义,同时确保Mermaid代码块的格式被GitLab识别。修改后的Quarto源文件如下: ```yaml --- title: "test gfm mermaid" format: gfm: pandoc_args: ["--no-escape"] code-blocks: preserve --- Text ```{mermaid} flowchart LR A-->B
## 验证结果 重新执行渲染命令后,生成的Markdown文件中Mermaid代码段将保持原始箭头格式: ```markdown # test gfm mermaid Text ```mermaid flowchart LR A-->B
此时GitLab Wiki可以正常渲染该Mermaid流程图。 --- 内容的提问来源于stack exchange,提问作者acapet
相关产品推荐
相关产品推荐

