You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

在生成GitLab Wiki的Quarto文档中嵌入Mermaid图遇转义问题求助

解决Quarto生成GFM时Mermaid箭头转义导致GitLab Wiki无法渲染的问题

问题

通过Quarto生成包含Mermaid流程图的GitLab Wiki页面时,生成的Markdown文件中Mermaid代码里的箭头-->被转义为-->,导致GitLab无法正常渲染该流程图。

复现步骤

  1. 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
  1. 生成的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
相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.01 12:48:27