1. 从 Markdown 到专业 PDF为什么你需要 Pandoc如果你经常写技术文档、学术报告或者像我一样喜欢用 Markdown 来整理笔记和博客草稿那你一定遇到过这个需求如何把一份清爽的.md文件变成一份可以直接打印、提交或者分享的、排版精美的 PDF 文档很多人第一反应是“复制粘贴到 Word 里调格式”。我试过结果往往是灾难性的代码块格式全乱标题层级对不上图片位置飘忽不定调个半小时最后只想放弃。也有人会用一些在线的 Markdown 转 PDF 工具方便是方便但一旦涉及到复杂的数学公式、自定义字体、页眉页脚或者对排版有洁癖般的要求时这些工具就显得力不从心了。这时候Pandoc 就该登场了。它不是什么有华丽界面的软件而是一个命令行工具号称“文档转换的瑞士军刀”。它的核心能力就是让你用一种近乎“声明式”的方法告诉它“这是我的 Markdown 源文件这是我想要的 PDF 样子通过一个模板定义请按这个规则生成。” 而它背后真正负责把内容“画”到 PDF 页面上的是 LaTeX 这个专业的排版系统。所以当你使用 Pandoc 将 Markdown 转为 PDF 时你实际上是在借用 LaTeX 数十年来积累的、在学术出版界被视为金标准的排版能力。简单来说Pandoc 解决了从“内容”Markdown到“精美呈现”PDF之间的巨大鸿沟。它特别适合以下人群技术写作者、学术研究者、需要生成标准化报告的程序员以及任何厌倦了手动排版、希望内容与样式分离的文档生产者。学习它初看有点门槛但一旦掌握你会发现它带来的效率提升和格式稳定性是革命性的。2. 环境搭建安装 Pandoc 与 LaTeX 发行版工欲善其事必先利其器。要让 Pandoc 顺利输出 PDF你需要安装两个核心组件Pandoc 本身和一个完整的 LaTeX 发行版。Pandoc 负责解析和转换文档结构而 LaTeX 则扮演“排版引擎”和“字体渲染器”的角色。2.1 安装 PandocPandoc 的安装非常直接各平台都有官方包支持。Windows最推荐的方式是下载官方的.msi安装包。访问 Pandoc 的 GitHub Release 页面找到最新版本的pandoc-x.x.x-windows-x86_64.msi文件下载并运行。安装程序会自动将 Pandoc 添加到系统路径之后你就可以在命令提示符或 PowerShell 中直接使用pandoc命令了。macOS如果你安装了 Homebrew那么一行命令就能搞定brew install pandoc。这是最省心的方式。你也可以从官网下载.pkg安装包。Linux大多数发行版的仓库里都有 Pandoc。例如在 Ubuntu/Debian 上可以sudo apt install pandoc在 Fedora 上可以sudo dnf install pandoc。安装完成后打开终端或命令提示符输入pandoc --version如果能看到版本号信息说明安装成功。2.2 安装 LaTeX 发行版这是关键一步也是让很多新手困惑的一步。Pandoc 默认使用 LaTeX 来生成 PDF所以你必须安装一个 LaTeX 发行版它包含了成千上万个排版所需的宏包、字体和工具。TeX Live这是跨平台Windows, macOS, Linux最通用、最全面的选择。它的安装包很大几个GB因为它包含了几乎所有你可能用到的宏包避免了后续“缺包”的烦恼。Windows下载install-tl-windows.exe安装器。注意安装界面可能有点复古安装时间较长请耐心等待。务必勾选“将 TeX Live 可执行文件目录添加到系统 PATH”的选项。macOS推荐使用 MacTeX 发行版它本质上是为 macOS 定制的 TeX Live并附带了一个 GUI 管理工具。下载MacTeX.pkg安装即可。Linux可以通过包管理器安装如sudo apt install texlive-full安装完整版推荐或sudo apt install texlive-latex-extra安装常用扩展包。MiKTeX主要面向 Windows 用户。它的特点是“按需安装”即只在编译文档真正需要某个宏包时才从网络下载安装初始安装体积小。但对于需要稳定、离线环境的用户或者网络环境不佳时可能会造成编译中断。我个人更倾向于一次性装完的 TeX Live省去后续麻烦。安装好 LaTeX 后同样在终端测试一下输入xelatex --version或pdflatex --version能输出信息即可。这里提一下xelatex和pdflatex它们是 LaTeX 的编译引擎。pdflatex对中文支持需要额外配置而xelatex原生支持 Unicode 和系统字体对中文处理更友好是我们后续会主要使用的引擎。2.3 验证安装与简单测试环境装好后我们来做个最简单的测试。创建一个纯文本文件命名为test.md内容如下# 测试文档 这是一个来自 Pandoc 的测试。 - 列表项一 - 列表项二 **这里是加粗文字**。保存后在该文件所在目录打开终端执行命令pandoc test.md -o test.pdf如果一切顺利你会看到终端闪过一些 LaTeX 编译信息然后目录下就生成了一个test.pdf。用 PDF 阅读器打开它虽然样式很基础默认的 LaTeX 文章样式但内容结构标题、列表、加粗都正确转换了。恭喜你的 Pandoc 流水线已经打通了3. 基础转换理解命令与核心选项上一节我们用了最简单的pandoc input.md -o output.pdf命令完成了转换。现在我们来拆解这个命令并了解一些最常用、能立刻提升输出质量的选项。3.1 命令结构解析一个典型的 Pandoc 命令由以下几部分组成pandoc [输入文件] [选项] -o [输出文件]输入文件你的源文件如my_doc.md。Pandoc 支持非常多的输入格式通过文件后缀自动识别。-o选项指定输出文件。Pandoc 根据输出文件的后缀决定转换格式比如.pdf,.docx,.html等。[选项]用来控制转换过程的各种参数。这是 Pandoc 强大之处的体现。3.2 影响 PDF 输出的关键选项直接转换的 PDF 往往不符合我们的审美。通过以下选项你可以快速定制--pdf-engine指定生成 PDF 的引擎。这是最重要的选项之一。pdflatex默认引擎。处理西文很好但直接处理中文容易出问题。xelatex推荐用于中文文档。它支持 Unicode 和直接调用系统字体是处理中日韩文字的首选。lualatex另一个现代引擎同样支持 Unicode 和字体比xelatex在某些高级字体特性上更强大。wkhtmltopdf,weasyprint通过 HTML/CSS 路径生成 PDF适合需要精确 CSS 控制的场景但复杂排版和数学公式支持不如 LaTeX 路径。使用示例pandoc doc.md --pdf-enginexelatex -o doc.pdf-V或--variable设置 LaTeX 模板变量。LaTeX 模板通过变量来控制样式。你可以用这个选项覆盖默认值。mainfont设置正文字体。例如使用 Windows 系统里的微软雅黑-V mainfontMicrosoft YaHeiCJKmainfont专门设置中文字体当使用xelatex时mainfont和CJKmainfont通常需要同时设置成中文字体。fontsize设置基础字体大小如12pt。papersize纸张大小如a4paper。geometry通过geometry宏包设置页边距格式为-V geometry:margin1in。组合示例pandoc doc.md --pdf-enginexelatex -V mainfontSimSun -V fontsize12pt -V geometry:margin1in -o doc.pdf--template指定自定义的 LaTeX 模板文件。Pandoc 转换 PDF 时其实是先把你 Markdown 的内容填充到一个 LaTeX 模板里再编译这个.tex文件。默认有一个模板但我们可以用自己的。这个我们会在高级章节详细讲。--listings这是一个针对代码高亮的实用选项。默认情况下Pandoc 可能会用一些简单的 LaTeX 命令来处理代码块效果一般。使用--listings选项会调用 LaTeX 的listings宏包来渲染代码它可以提供语法高亮、边框、背景色等需要配合高亮主题。但注意listings对复杂语言的支持有限。--highlight-style指定代码高亮的样式主题。Pandoc 内置了一些主题如pygments,tango,espresso,zenburn等。这个选项需要和--listings配合或者当输出格式为 HTML 时效果明显。对于 PDFLaTeXlistings宏包有自己的一套配色定义通常需要在模板中配置这个选项的影响方式有所不同。3.3 一个实用的基础命令示例假设我们有一份中文技术报告report.md希望生成 A4 纸、有页边距、使用宋体、用xelatex引擎的 PDF。一个相对完整的命令如下pandoc report.md \ --pdf-enginexelatex \ -V CJKmainfontSimSun \ -V fontsize12pt \ -V papersizea4 \ -V geometry:margin2.5cm \ --toc \ -o report.pdf这里我们用了\来让命令在终端中换行书写更清晰。新增了--toc选项它会根据 Markdown 的标题层级自动生成一个目录。执行这个命令你会得到一份比默认样式好看得多、也更实用的 PDF 文档。这已经能满足很多日常需求了。但如果你对排版有更高要求比如特定的标题样式、公司 Logo、奇偶页不同的页眉页脚那就需要深入到模板的世界了。4. 深入核心LaTeX 模板定制化当你不再满足于通过-V变量进行微调想要完全掌控 PDF 的每一处细节时自定义 LaTeX 模板就是必经之路。这听起来很“硬核”但理解其工作原理后你会发现它其实非常直观和强大。4.1 模板是什么如何工作你可以把 LaTeX 模板想象成一个“填空题”试卷。试卷上已经印好了版式、装饰、固定的提示文字比如“姓名”、“标题”。Pandoc 的工作就是把你的 Markdown 内容解析成一个个“答案”标题、作者、日期、正文段落、代码块等然后填到这张试卷对应的“空白”里。最后LaTeX 引擎把这张填好的试卷编译成漂亮的 PDF。Pandoc 在转换时默认使用一个内置的模板。我们可以先把这个默认模板“考贝”出来看看pandoc -D latex default.latex这个命令会生成一个default.latex文件。用文本编辑器打开它你会看到很多以$括起来的变量如$title$,$author$,$date$,$body$。$body$就是你的 Markdown 正文内容会被填入的地方。模板的其他部分就是控制文档类型、加载宏包、定义页面样式、设置字体等 LaTeX 代码。4.2 创建一个最小化自定义模板我们不需要从头写。最好的方法是复制默认模板然后按需修改。假设我们想创建一个简单的模板my_template.latex。第一步获取并修改默认模板pandoc -D latex my_template.latex用编辑器打开my_template.latex。我们来做几个常见修改修改文档类找到\documentclass[...]{...}这一行。默认可能是article。你可以换成其他类比如report有章节或者ctexart中文文章类能简化中文配置。这里我们为了演示先保持article。添加中文支持宏包在\documentclass之后\begin{document}之前有一片区域是加载宏包的\usepackage{...}。为了用xelatex处理中文我们需要添加\usepackage{xeCJK} \setCJKmainfont{SimSun} % 设置中文字体为宋体 \usepackage{fontspec} \setmainfont{Times New Roman} % 设置西文字体修改页边距使用geometry宏包。在宏包区域添加\usepackage[margin2.5cm]{geometry}。定制标题样式找到模板中定义$title$、$author$显示的地方。默认可能只是简单地\maketitle。我们可以自己定义。例如在\begin{document}之后$body$之前替换掉\maketitle用以下代码实现一个居中的标题\begin{center} {\LARGE \textbf{$title$}} \\[0.5cm] {\large $author$} \\[0.2cm] {\small $date$} \end{center} \vspace{1cm} % 标题与正文之间的间距第二步使用自定义模板保存my_template.latex文件。在转换命令中通过--template选项指定它pandoc report.md --pdf-enginexelatex --templatemy_template.latex -o report_custom.pdf现在生成的 PDF就会完全遵循你模板中定义的样式中文字体是宋体页边距是 2.5cm标题是自定义的居中大号加粗样式。4.3 模板中的条件判断与高级用法Pandoc 模板支持简单的条件判断这非常有用。语法是$if(variable)$ ... $endif$。例如你的 Markdown 文件可能有时有作者有时没有。在模板中你可以这样处理作者行$if(author)$ {\large 作者$author$} \\[0.2cm] $endif$这样只有当 Markdown 文件头部用author: 张三定义了作者时这一行才会被输出到 PDF 中。另一个强大的功能是处理代码高亮。如果你想在模板中配置listings宏包的高亮风格可以在宏包区域添加\usepackage{listings} \usepackage{xcolor} \lstset{ basicstyle\ttfamily\small, keywordstyle\color{blue}, commentstyle\color{green!60!black}, stringstyle\color{red}, framesingle, breaklinestrue, tabsize4 }然后在 Pandoc 命令中使用--listings选项这样你的代码块就会以lstset中定义的样式呈现。注意修改模板后一个常见的错误是 LaTeX 编译报错比如“未找到字体”或“宏包冲突”。这时候仔细阅读终端输出的错误信息通常是英文错误信息会告诉你问题出在哪一行。字体问题确保字体名正确且系统已安装宏包冲突可能需要注释掉某些不兼容的\usepackage。调试模板是一个“编辑-编译-报错-再编辑”的循环耐心是关键。5. 实战从复杂 Markdown 到精美报告理论说再多不如一个实际例子来得透彻。假设我们要将一份包含章节、数学公式、代码块、表格和图片的技术报告final_report.md转换成一份可以直接提交的、格式专业的 PDF。我们将一步步拆解这个过程。5.1 源文件分析与 Front Matter首先看看我们的final_report.md可能长什么样。除了常规的 Markdown 内容我们可以在文件最开头使用 YAML Front Matter 来定义一些元数据这些信息会被 Pandoc 读取并传递给模板变量。--- title: 深度学习模型在图像识别中的应用实践报告 author: [张三, 李四] date: 2023-10-27 abstract: 本报告详细阐述了基于卷积神经网络(CNN)的图像分类模型从数据预处理到模型部署的全流程并对关键超参数的影响进行了实验分析。 keywords: [深度学习, CNN, 图像识别, PyTorch] geometry: margin2.5cm fontsize: 11pt mainfont: Times New Roman CJKmainfont: SimSun header-includes: - \usepackage{graphicx} - \usepackage{booktabs} - \usepackage{amsmath} --- # 第一章 引言 随着人工智能技术的发展... ## 1.1 研究背景 ... # 第二章 模型设计 我们采用了经典的 ResNet-34 架构... ## 2.1 网络结构 其残差块结构可由以下公式表示 $$y \mathcal{F}(x, \{W_i\}) x$$ ... ## 2.2 代码实现 核心训练循环代码如下 python import torch import torch.nn as nn model ResNet34(num_classes10) criterion nn.CrossEntropyLoss() optimizer torch.optim.Adam(model.parameters(), lr0.001) for epoch in range(num_epochs): for images, labels in train_loader: # ... 训练步骤...第三章 实验结果实验结果如下表所示模型准确率参数量ResNet-1894.5%11.2MResNet-3495.8%21.3M我们的模型96.2%19.7M{ width80% } ...这个文件包含了标题、作者列表、日期、摘要、关键词等元数据以及章节、公式、代码块、表格和图片。 ### 5.2 构建对应的 LaTeX 模板 针对这份报告我们创建一个更专业的模板 report_template.latex。这个模板会 1. 使用 ctexart 文档类简化中文处理。 2. 定义封面页。 3. 生成目录。 4. 设置页眉页脚。 5. 优化图表标题样式。 模板内容节选如下 latex % 报告模板 - report_template.latex \documentclass[fontsetwindows, $fontsize$]{ctexart} \usepackage[$geometry$]{geometry} \usepackage{fancyhdr} \usepackage{titling} \usepackage{graphicx} \usepackage{booktabs} \usepackage{listings} \usepackage{xcolor} \usepackage{amsmath} \usepackage[labelfontbf]{caption} % 代码高亮设置 (使用 listings) \lstset{ languagePython, basicstyle\ttfamily\footnotesize, keywordstyle\color{blue}, commentstyle\color{gray}, stringstyle\color{red}, numbersleft, numberstyle\tiny\color{gray}, framesingle, breaklinestrue, tabsize4, showstringspacesfalse } % 页眉页脚设置 \pagestyle{fancy} \fancyhf{} \fancyhead[C]{$title$} \fancyfoot[C]{\thepage} \renewcommand{\headrulewidth}{0.4pt} % 封面页定义 \pretitle{\begin{center}\Huge\bfseries} \posttitle{\par\end{center}\vskip 1em} \preauthor{\begin{center}\large} \postauthor{\par\end{center}} \predate{\begin{center}\large} \postdate{\par\end{center}} \title{$title$} \author{$for(author)$$author$$sep$ \and $endfor$} \date{$date$} \begin{document} % 封面页 \maketitle \thispagestyle{empty} % 封面页不显示页眉页脚 \begin{abstract} $abstract$ \end{abstract} \textbf{关键词} $for(keywords)$$keywords$$sep$, $endfor$ \newpage % 目录 \tableofcontents \thispagestyle{empty} % 目录页不显示页眉页脚 \newpage \setcounter{page}{1} % 正文从第1页开始 % 正文内容 $body$ \end{document}5.3 执行转换命令与排错现在使用这个模板和更完整的命令来生成 PDFpandoc final_report.md \ --pdf-enginexelatex \ --templatereport_template.latex \ --listings \ --toc \ -V geometry:margin2.5cm \ -V fontsize11pt \ -o final_report.pdf命令解析--templatereport_template.latex使用我们精心设计的模板。--listings启用listings宏包来渲染代码块使其符合模板中的\lstset设置。--toc生成目录。注意我们的模板中已经有\tableofcontents命令这个选项会确保 Pandoc 生成目录所需的数据。-V变量这里覆盖了模板中$geometry$和$fontsize$变量的值。实际上这些值已经在源文件的 Front Matter 里定义了命令行的-V优先级更高。可能遇到的坑与解决方案图片路径问题LaTeX 对图片路径比较敏感。如果loss_curve.png不在和 Markdown 文件相同的目录或者编译时的当前目录不对就会报错“Fileloss_curve.pngnot found”。解决方案确保图片路径正确或者使用绝对路径。更稳健的做法是在 Markdown 中写相对路径并在编译时确保终端工作目录正确。字体缺失如果系统没有安装“SimSun”宋体或“Times New Roman”xelatex会报错。解决方案确认字体已安装或者将CJKmainfont和mainfont变量改为你系统里有的字体名如“Microsoft YaHei”。宏包冲突或未安装如果模板中引用了未安装的 LaTeX 宏包如minted用于更高级的代码高亮会编译失败。解决方案使用 TeX Live 的tlmgr命令在线安装缺失宏包例如sudo tlmgr install minted。对于常见的booktabs,caption,fancyhdr等完整版 TeX Live 通常已包含。编码问题如果 Markdown 文件或模板文件保存的编码不是 UTF-8中文字符可能会显示为乱码。解决方案确保所有文本文件均以 UTF-8 编码保存。执行成功后final_report.pdf将是一份拥有专业封面、目录、页眉页脚、格式化工整的代码和表格、图片位置正确的完整报告。这个过程虽然前期需要一些配置但一旦模板定型后续所有同类报告都可以一键生成格式绝对统一效率的提升是巨大的。6. 进阶技巧与工作流优化掌握了基础转换和模板定制后我们可以追求更高的工作效率和更优雅的输出效果。这一节分享一些能让你“事半功倍”的进阶技巧。6.1 使用元数据文件与默认配置每次都在命令行里写一长串选项很麻烦。Pandoc 支持使用 YAML 格式的元数据文件例如defaults.yaml来保存默认配置。创建一个defaults.yaml文件# defaults.yaml pdf-engine: xelatex template: report_template.latex listings: true toc: true variables: geometry: margin2.5cm fontsize: 11pt CJKmainfont: Microsoft YaHei mainfont: Arial然后在命令行中只需引用这个配置文件再指定输入输出文件即可pandoc --defaults defaults.yaml report.md -o report.pdfPandoc 会自动应用配置文件中的所有选项。你还可以为不同的项目创建不同的配置文件如blog_defaults.yaml,thesis_defaults.yaml实现配置的模块化管理。6.2 集成到编辑器和自动化脚本手动敲命令还是不够“极客”。我们可以将这个过程集成到日常使用的编辑器中。VS Code安装“Markdown PDF”插件固然方便但它定制性有限且可能依赖 Chrome。更灵活的方式是配置 VS Code 的tasks.json。你可以创建一个任务调用 Pandoc 命令来转换当前文件。更进一步可以绑定一个快捷键如CtrlShiftP来快速运行这个任务。自动化脚本写一个简单的 Shell 脚本Linux/macOS或批处理文件Windows来批量处理。例如一个convert_all.sh脚本#!/bin/bash for file in *.md; do if [ -f $file ]; then pandoc --defaults defaults.yaml $file -o ${file%.md}.pdf echo 已转换: $file - ${file%.md}.pdf fi done运行这个脚本可以一键将当前目录下所有.md文件转换成 PDF。6.3 处理复杂元素数学公式、参考文献与交叉引用数学公式Pandoc 对 LaTeX 数学公式的支持是原生的。行内公式用$...$行间公式用$$...$$。在模板中确保加载了amsmath宏包即可完美渲染。这是 Pandoc LaTeX 方案相比其他转换工具的巨大优势。参考文献如果你需要引用学术文献Pandoc 支持通过 BibTeX 管理参考文献。将参考文献条目保存在一个.bib文件中如refs.bib。在 Markdown 文件中使用[citation_key]的格式进行引用。在转换命令中添加--citeproc选项来处理引用并通过--bibliographyrefs.bib指定文献库。Pandoc 会自动生成文末的参考文献列表和文中的引用标号。图表交叉引用这是 LaTeX 的强项但在 Pandoc 的 Markdown 中需要一点技巧。你可以使用{#fig:label}或{#tbl:label}这样的语法为图片或表格添加标签然后用\ref{fig:label}在文中引用。但是这需要 Pandoc 的--pdf-engine是lualatex或xelatex并且可能需要额外的过滤器如pandoc-crossref来获得更好的支持。对于简单的文档手动维护编号可能更直接对于大型学术文档深入研究和配置pandoc-crossref是值得的。6.4 调试与日志分析当转换失败时终端会输出大量有时令人困惑的LaTeX 错误日志。不要慌关键信息通常在最后几行。错误信息会指出问题所在的.tex文件行数。Pandoc 在转换过程中会生成一个临时的.tex文件你可以通过添加--verbose选项来保留它pandoc input.md --pdf-enginexelatex -o output.pdf --verbose 21 | tee log.txt这个命令会将详细输出同时显示在屏幕和保存到log.txt文件中。在日志中搜索“Error:”或“!”找到第一个报错点然后去查看 Pandoc 生成的中间.tex文件通常以tmp开头定位到出错的那一行就能知道是模板问题、变量问题还是内容本身的问题了。7. 替代方案对比与 Pandoc 的适用边界虽然 Pandoc 功能强大但它并非在所有场景下都是最佳选择。了解其他工具的特点能帮助你做出更合适的技术选型。7.1 主流替代方案速览Typora / MarkText 等所见即所得编辑器它们内置了“导出为 PDF”功能通常基于 Chromium 渲染。优点极其简单一键导出对于样式要求不高的日常笔记非常方便。缺点定制能力弱无法精细控制排版如页眉页脚、章节样式对复杂数学公式和代码块的支持取决于其内部渲染器批量处理能力弱。VS Code 插件 (如 Markdown PDF)在编辑器内直接转换。优点与编辑环境集成方便快捷。缺点同样依赖 HTML/CSS 渲染路径定制性受插件限制高级 LaTeX 功能无法使用。md-to-pdf等 Node.js 库基于markdown-it解析和puppeteer无头 Chrome渲染。优点可通过 CSS 实现非常现代的网页样式适合需要精确还原网页设计稿的场景。缺点需要 Node.js 环境排版能力尤其是分页控制、数学公式渲染质量依然不如 LaTeX 专业。直接使用 LaTeX跳过 Markdown直接编写.tex文件。优点拥有终极的排版控制权是学术出版和复杂排版的唯一选择。缺点学习曲线极其陡峭写作效率低内容与样式高度耦合。7.2 Pandoc 的核心优势与适用场景经过对比Pandoc 的核心优势在于它在“书写效率”和“排版质量”之间取得了绝佳的平衡。适用场景技术文档与报告需要包含大量代码、公式、图表且对格式有统一、专业的要求。学术写作需要处理参考文献、交叉引用、符合特定出版格式通过定制模板实现。批量文档生成需要将一批结构类似的 Markdown 文件转换为格式统一的 PDF。自动化工作流作为脚本的一部分集成到 CI/CD 流程中自动生成产品文档、发布说明等。不适用场景追求极致“所见即所得”如果你希望在写作时就看到和最终 PDF 一模一样的版面Pandoc 不适合它本质是“编译”过程。需要复杂动态内容或交互式元素PDF 是静态的Pandoc 生成 PDF 的路径也不支持 JavaScript 等动态内容。对 LaTeX 完全无法接受如果你或你的团队坚决不想接触任何 LaTeX 相关配置安装、模板、排错那么基于 HTML/CSS 的方案可能心理负担更小。我个人在实际项目中的体会是对于个人知识管理、博客文章初稿我可能用 Typora 快速导出预览。但对于任何需要正式提交、共享或印刷的文档尤其是涉及团队协作和格式规范的Pandoc 自定义模板 是我的不二之选。它前期投入的学习成本会在日后无数次的“一键生成”中加倍回报回来。那份由代码和纯文本内容生成精美版式的确定性和自动化快感是其他工具难以替代的。