使用 Markdown 编写 LaTeX 文档

Markdown 编辑器直接导出的 pdf 文档的质量往往欠佳,直接写 LaTeX 又太麻烦。本文简要记录了两种使用 Markdown 编写 LaTeX 文档的方法。 方法一:Pandoc Pandoc 是一个非常强大的文档转换器,可以在各种文档格式之间转换。 基本用法 使用 pandoc report.md -o report.tex 就可以将 Markdown 转换为 LaTeX 源文件。不过这样得到的 LaTeX 源文件是不完整的,可以加上 -s 或 --standalone 来生成完整的可以直接编译的 LaTeX 源文件。注意 Pandoc 对 Markdown 的格式要求比较严格,需要确保每个块(正文段、标题、列表、代码块等)之间都有空行分隔。 pandoc report.md -o report.tex -s 也可以直接转换成 pdf 文件,这时候不需要 -s,可以用 --pdf-engine= 来指定渲染引擎。 pandoc report.md -o report.pdf --pdf-engine=xelatex 可以直接在 Markdown 中使用 tex 命令,pandoc 会将其原样保留,这样就可以插入无法用 Markdown 表示的内容。如果觉得这样不够清晰,也可以使用 pandoc 的 generic raw attribute 功能, 把 tex 命令写在标记为 ```{=tex} 的代码块中。