在学术写作中，在这个“内容为王”但“格式折磨人”的领域，许多研究者将大量时间浪费在了调整 Word 文档的缩进、字体和参考文献格式上。本文将介绍一种高效的“纯文本”工作流：使用严格 Markdown 编写内容，并利用 Pandoc 进行专业的格式化输出。

为什么要选择 Markdown + Pandoc？

  • 虽然无格式，胜似有格式：Markdown 让你专注于文字本身，通过语义标记（这是标题、那是列表）而非视觉标记（字号大一点、加粗）来写作。
  • Pandoc 的魔力：被称为文档转换界的“瑞士军刀”，它可以将你的 Markdown 文本完美转换为符合期刊要求的 PDF、Word (docx) 甚至 HTML 幻灯片。
  • 版本控制：纯文本文件极小且易于使用 Git 进行版本管理。

严格 Markdown 语法指南

为了确保文档的可移植性和 Pandoc 的正确解析，遵循严格的 Markdown 语法至关重要。这意味着要摒弃某些编辑器特有的“方言”，回归标准。

1. 标题 (Headers)

使用 # 符号标记标题层级。注意：# 后必须加一个空格。

1
2
3
# 一级标题 (通常作为论文题目)
# 二级标题 (章节)
## 三级标题 (子章节)

2. 段落与换行 (Paragraphs)

在 Markdown 中，段落之间必须使用一个空行隔开。仅按一次回车通常会被视为空格（软换行），这在 LaTeX 渲染中尤为重要。

1
2
3
这是第一段内容。

这是第二段内容。中间必须有空行。

3. 列表 (Lists)

无序列表使用 -、+ 或 *，有序列表使用数字加点。注意：符号后同样需要空格。

1
2
3
4
5
6
- 方法 A
- 方法 B
  - 子方法 B.1 (缩进 2 或 4 个空格)

1. 第一步
2. 第二步

4. 代码块与引用 (Code & Blockquotes)

插入代码或算法伪代码时，使用三个反引号。引用文献内容使用 >。

1
2
3
4
5
> 这是一个引用块。

```python
def hello():
    print("world")

5. 强调 (Emphasis)

使用双星号表示加粗（语义上的 Strong），单星号表示斜体（语义上的 Emphasis）。请避免使用下划线，因为在处理数学公式时可能会引起歧义。

面向学术的 Pandoc 扩展

标准 Markdown 难以满足论文需求，但 Pandoc 提供了关键的扩展语法。

1. YAML 元数据块 (Metadata)

在文档的最开头，使用三条短横线包裹文档的元信息。Pandoc 会读取这些信息生成封面或页眉。

1
2
3
4
5
6
---
title: 论 Markdown 在学术写作中的应用
author: 张三
date: 2024-01-24
bibliography: references.bib
---

2. 数学公式 (Math)

Pandoc 支持标准的 LaTeX 语法插入公式。

  • 行内公式：使用单个美元符号 $E=mc^2$。
  • 独立公式：使用两个美元符号。
1
2
3
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

3. 脚注 (Footnotes)

使用 [^标识符] 的格式。

1
2
3
这在这个研究中得到了证实[^1]。

[^1]: 参见 Smith (2020) 的实验结果。

4. 参考文献 (Citations)

配合 .bib 文件，你可以使用 @ 符号引用。

1
2
根据 @smith2023 的研究...
这一结论已被多方证实 [@doe2022; @lee2021]。

使用 Pandoc 快速格式化

编写完成后，使用命令行调用 Pandoc 进行转换。

转换为 Word (docx)

这是最通用的格式，适合发送给导师修改。

1
pandoc paper.md -o paper.docx --reference-doc=custom-reference.docx

技巧：你可以制作一个设置好字体、页边距的 custom-reference.docx 作为模板。

转换为 PDF

生成专业的排版（通常需要安装 LaTeX 环境，如 TeX Live）。

1
pandoc paper.md -o paper.pdf --pdf-engine=xelatex -V mainfont="SimSun"
  • --pdf-engine=xelatex：推荐用于处理中文字符。
  • -V mainfont="SimSun"：指定中文字体（如宋体），防止乱码。
  • --bibliography=refs.bib：处理参考文献。
  • --csl=ieee.csl：指定引用格式（如 IEEE, APA 等）。

结语

通过“严格 Markdown + Pandoc”的工作流，你将彻底告别“调整图片位置导致全文乱序”的噩梦。内容与格式的分离，正是高效写作的精髓所在。现在，打开你最喜欢的文本编辑器，开始专注的写作之旅吧。

1