Markdown to PDF

学习

如何把 Mermaid 图表导出为 PDF

从 Markdown 渲染 Mermaid 图表,并导出成共享后依然清晰的 PDF。

发布 April 20, 2026·更新 April 20, 2026

导出后依然清晰的 Mermaid 图表

Mermaid 很适合画流程图、时序图和架构快照,但在不同工具之间来回移动时经常容易出问题。采用以 Markdown 为中心的导出方式,可以让图表始终紧贴周围说明文字。

更稳妥的做法,是让每张图都靠近解释它的那段文字。这样导出的 PDF 会更像一份完整文档,而不是后期把几张截图拼到一起。

让图表导出效果更好的建议

  • 节点标签尽量短。
  • 能避免就不要做得过宽。
  • 一张图只讲一个主要想法。
  • 图前图后各补一句说明,给读者上下文。

模板推荐

如果文档里 Mermaid 图较多,Creative 往往更合适。它会给视觉内容更多空间,让图表看起来像文档的一部分,而不是临时加上的附件。