mermaid LaTeX 图表教程：3 条命令把文本描述变成 PDF 插图

mermaid LaTeX 图表教程3 条命令把文本描述变成 PDF 插图【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaidmermaid 是一款用类 Markdown 文本生成流程图的开源库配合 mermaid CLI把文本描述转成 SVG 图的命令行工具可以先在本地把.mmd源文件渲染成 SVG再嵌入 LaTeX 编译为 PDF。这套 mermaid LaTeX 图表工作流适合第一次接触它、需要在论文或技术报告里反复修改图表的读者本文按先跑通、再走完整流程、最后排坑的顺序让你在 5 分钟内看到第一张插图。先跑通mermaid-cli 安装与第一条命令前提是你已经装好 Node.jsv14 及以上和 LaTeX 发行版TeX Live 或 MiKTeX 均可Linux、macOS、Windows 都适用。运行下面两条命令完成安装并验证版本npm install -g mermaid-js/mermaid-cli mmdc --version能打印出版本号就说明mmdcmermaid CLI 的可执行文件名已就绪。当前 mermaid 主包版本为 v11.17.0CLI 与其同步维护。端到端工作流从 .mmd 源文件到 PDF 的 4 步整个链路只有一条主路径写文本 → 转 SVG → LaTeX 引用 → 编译。第 1 步写一个最小源文件。新建diagram.mmd内容就是纯文本图表描述flowchart TD A[原始数据] -- B[数据清洗] B -- C[模型训练] C -- D[评估报告]第 2 步用 mmdc 转成 SVG。运行这条命令-t指定主题可选 default、forest、dark、neutral 四种-b transparent让背景透明避免在 PDF 里出现白底框mmdc -i diagram.mmd -o diagram.svg -t forest -b transparent执行后同目录下会生成diagram.svg几个 KB 大小可无限缩放。第 3 步在 LaTeX 文档中引入 SVG。在.tex的导言区加svg包graphicx、float一般已有正文放这段 3 行配置\usepackage{svg} \includesvg[width0.8\textwidth]{diagram.svg}注意用\includesvg而不是\includegraphics前者会把 SVG 转成 PDF 矢量内容嵌入文字保持可选中。第 4 步编译出 PDFpdflatex main.tex改图时只需编辑.mmd文件重跑第 2、4 步不用打开任何画图软件。把.mmd文件提交进 Git评审人看到的每次修改都有记录。图表能力速查4 种常用图的写法对照mermaid 内置流程图、时序图、类图、甘特图等 20 多种类型写法都是第一行声明类型 缩进写内容。学术文档里最常用的是下面四种各给一句话定位flowchart算法与流程描述支持subgraph分组和style着色sequenceDiagram系统交互与协议分析用-表示请求、--表示返回classDiagram面向对象设计图表示公有成员1 -- *表示一对多关系gantt项目时间线dateFormat YYYY-MM-DD声明日期格式任务行可写开始日期加时长。一段甘特图的典型写法长这样节选自项目自带的语法示例完整语法可看 docs/syntax/gantt.mdgantt title 项目时间线 dateFormat YYYY-MM-DD section 调研 文献收集 :a1, 2024-01-01, 30d section 实验 方案制定 :a2, after a1, 30d另外两个和论文直接相关的能力从 v10.9.0 起支持在节点和标签里写 LaTeX 数学公式用$$...$$包裹即可默认走 MathML 渲染主题切换只需改mmdc的-t参数同一份源文件可输出不同配色的 SVG。踩坑与排查4 个高频问题SVG 显示异常几乎都是用了\includegraphics引入 SVG改回\includesvg即可中文乱码SVG 里的文字需要 LaTeX 中文字体支持编译改用xelatex并设置 CJK 字体如\setCJKmainfont{Noto Serif CJK SC}样式不统一全文档固定同一个-t主题值写进构建脚本避免每个图手动指定图多以后编译慢用循环批量转 SVG只重新生成有改动的图for f in diagrams/*.mmd; do base$(basename $f .mmd) mmdc -i $f -o build/$base.svg -t forest -b transparent done pdflatex main.tex把.mmd与脚本一起提交仓库CI 里跑同一段循环即可自动重渲染。CLI 本身的配置项文档见 docs/config/theming.md。下一步行动用第 1 节的 2 条命令装好mmdc先渲染任意一个 flowchart把论文里一张现有图改写成.mmd文本跑通转 SVG → 嵌入 → 编译的 4 步链路把图表源文件和批量转换脚本提交进 Git开始用版本记录图表的每次修改。【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaid创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考