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

0 阅读1分钟

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

0.1.3 版本更新 🆕

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

Mermaid 图表支持 🌈

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

那怎么用呢?很简单,直接在 Markdown 文件里写 Mermaid 代码就行:

```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