M4-更新日志v0.1.3-Mermaid图表支持 [特殊字符]

EnCi Zheng2026-05-02 8:19

M4-更新日志v0.1.3-Mermaid图表支持 📝

0.1.3 版本更新 🆕

今天来聊聊 0.1.3 版本的新变化，这次我们带来了一个超棒的特性------Mermaid 图表支持！🎉

Mermaid 图表支持 🌈

从 markconv 0.1.3 版本开始，你们在导出 HTML 和 PDF 的时候可以直接渲染 Mermaid 图表啦！以后画流程图、时序图什么的就方便多了～

那怎么用呢？很简单，直接在 Markdown 文件里写 Mermaid 代码就行：

markdown 复制代码

```mermaid
graph TD
    A[开始] --> B{判断}
    B -->|条件1| C[处理1]
    B -->|条件2| D[处理2]
    C --> E[结束]
    D --> E

复制代码

目前支持这些类型的图表：

- 流程图 Flowchart
- 时序图 Sequence Diagram
- 类图 Class Diagram
- 状态图 State Diagram
- 实体关系图 ER Diagram
- 甘特图 Gantt Chart
- 饼图 Pie Chart
- 用户旅程图 User Journey

### 样式方面的小改进 🎨

我再说几个小细节：

**透明背景**这个功能我觉得挺实用的，Mermaid 图表默认用透明背景，看起来更清爽～

### 怎么使用 💻

无论是导出 PDF 还是 HTML，使用方法都一样：

```python
from markconv import MDConverter

converter = MDConverter()

# 导出 PDF
converter.to_pdf('input.md', 'output.pdf')

# 导出 HTML
converter.to_html('input.md', 'output.html')

技术实现 🔧

简单说说我们是怎么做的：

PDF 渲染用的是 mermaid-cli 库，在服务端把 Mermaid 代码直接渲染成 PNG 图片，然后嵌入到 PDF 里。

HTML 渲染不太一样，我们保留原始的 Mermaid 代码，让浏览器端的 Mermaid.js 库来动态渲染。所以 HTML 导出后需要引入 Mermaid.js CDN 才能正常显示图表。

依赖更新 📦

这次新增了一个依赖：

mermaid-cli>=0.1.3 - 用来渲染 Mermaid 图表

0.1.2 早期版本 📋

之前版本的功能比较简单：

基础 Markdown 转 HTML/PDF 功能
支持自定义 CSS 样式
支持中文内容

最后更新时间：2026-05-01