第 44 课：Markdown 与科研写作
🎯 核心实操目标
通关要求：建立"内容创作 vs 格式渲染分离"的工作流。本课你将掌握 Markdown 的 12 条核心语法，学会用 Pandoc 把 .md 一键转换为 DOCX / PDF / HTML 多格式输出，告别在 Word 里手动调字号的内耗，把写作精力放回研究本身。
📋 课前准备（5 分钟自检）
工具/环境
- [ ] VS Code（免费）：code.visualstudio.com
- [ ] VS Code 扩展：Markdown All in One + Markdown Preview Enhanced（在插件市场搜索安装）
- [ ] Pandoc（命令行格式转换器）：pandoc.org/installing.html
- [ ] 可选：Typora（所见即所得 Markdown 编辑器，付费但好用）
数据/素材
- [ ] 自己之前写过的任意一份学术草稿（Word 或文本均可，用于练习改写为 Markdown）
- [ ] 一份目标投稿期刊的 DOCX 参考模板（如有，用于 Pandoc reference-doc 参数）
配置验证
# 确认 Pandoc 安装成功
pandoc --version
# 应输出版本号(如 pandoc 3.x),无报错即成功应急通道
- 不想装 Pandoc → 用 Pandoc 在线版 临时演示
- VS Code 预览不工作 → 检查扩展是否启用，或重启编辑器
- 中文字体乱码 → Pandoc 转 PDF 时加
--pdf-engine=xelatex参数
场景痛点破冰：你是学者，不是排版人员
"快交稿前一晚，很多人通宵不睡，不是在打磨研究内容，而是在反复按空格键对齐文本。 因为你在 Word 里改错了一个编号，导致后面 300 个编号全部乱套。 图表一拉，整页断层。 把时间花在'三号还是小四号'的纠缠上，是对精力的极大浪费。 内容创作区与渲染表现区必须用一道清晰的边界彻底隔开。"
写学术内容这件事的本质是"输出有逻辑的思想"，而不是"排版样式"。Word 把这两件事混在一起，导致你每写一段就忍不住调字号、看预览、改字体——注意力被频繁打断。Markdown 的核心价值是把"内容"用最简单的纯文本符号标记好（# 是标题、**...** 是加粗），完全不操心样式；等内容写完了，用 Pandoc 一键转成漂亮的 DOCX/PDF。
🗺️ 架构重组：Write Once, Render Anywhere
一次写作，到处渲染。同一份 .md 源文件可以同时产出 PDF（投递学术期刊）+ DOCX（提交学校系统）+ HTML（发表博客）。这就是"Write Once, Render Anywhere"。
🚀 拆解实战 A：Markdown 12 条核心语法（速通）
90% 的学术写作只需要这 12 条语法。把它们当作"键盘快捷键"练熟，写作速度立刻提升 3 倍。
# 一级标题(文章主标题)
## 二级标题(章节)
### 三级标题(小节)
**加粗** *斜体* ~~删除线~~ `行内代码`
- 无序列表项 1
- 无序列表项 2
1. 有序列表项 1
2. 有序列表项 2
[链接文本](https://example.com)
> 引用块(适合摘录文献或他人观点)
| 列1 | 列2 | 列3 |
|---|---|---|
| 数据 | 数据 | 数据 |
行内数学公式: $E = mc^2$
独立公式块:
$$\bar{x} = \frac{1}{n}\sum_{i=1}^{n} x_i$$
代码块自动语法高亮:
```python
import pandas as pd
df = pd.read_csv("data.csv")
```
---
(三个减号表示水平分隔线)💡 学术写作的 Markdown 工作流（实战推荐顺序）
- 用 VS Code 打开
.md文件，按 Ctrl/Cmd + Shift + V 启动右侧实时预览 - 写作时完全无视样式——只关心标题层级和段落逻辑
- 写完后用 Pandoc 一键转 DOCX / PDF
- 在 DOCX 里做最后的精排（图表交叉引用、参考文献编号等）
⚠️ 不要在 Markdown 阶段塞 HTML 样式标签——那是把样式焦虑带回写作区，违背初衷。
🚀 拆解实战 B：Pandoc 一键转换
打开终端，准备好你的 paper.md 文件，跑以下命令：
# Markdown → DOCX (最常用)
pandoc paper.md -o paper.docx
# Markdown → PDF (需 LaTeX 环境)
pandoc paper.md -o paper.pdf --pdf-engine=xelatex
# Markdown → HTML (适合发博客/网页)
pandoc paper.md -o paper.html --standalone
# Markdown → DOCX 并应用目标期刊参考样式
pandoc paper.md --reference-doc=journal_template.docx -o paper_styled.docx
# 含数学公式的 Markdown → DOCX (启用 MathML)
pandoc paper.md -o paper.docx --mathml
# 带目录的 PDF
pandoc paper.md -o paper.pdf --toc --pdf-engine=xelatex--reference-doc 是关键功能：把目标期刊的 Word 模板（如 IEEE 投稿模板）当作"样式参考"，Pandoc 会自动把你的 Markdown 内容套用该模板的字体、字号、行距、段落间距。一行命令完成期刊投稿格式适配。
🚀 拆解实战 C：让 AI 把已有 Word 转回 Markdown
如果你已经写了大量 Word 草稿，想迁移到 Markdown 工作流：
# DOCX → Markdown
pandoc paper.docx -o paper.md --wrap=none
# 提取图片到独立文件夹
pandoc paper.docx -o paper.md --extract-media=./images或直接让 AI 帮你迁移：
【Role】你是一位精通 Markdown 与 Pandoc 工作流的技术写作顾问。
【任务】我把一份 Word 论文章节的纯文本粘贴在下方。请帮我:
1. 转换为标准 Markdown 格式(标题层级用 # / ## / ###)
2. 识别原文中的列表、引用、表格,正确转换为 Markdown 语法
3. 数学公式转为 LaTeX 行内 $...$ 或块状 $$...$$ 格式
4. 不要改动我的文字内容,只调整格式
【源文本】[在此粘贴 Word 复制出的纯文本]📦 本课交付物（提交给 AI 初审/讲师抽检）
- [ ] Markdown 写作样例：用 Markdown 写一篇 2 页研究笔记（含标题层级、列表、数学公式、表格至少各 1 个）
- [ ] Pandoc 转换截图：把上述
.md文件用 Pandoc 转为 DOCX 与 PDF，提交对照截图 - [ ] VS Code 工作流截图：左侧编辑器 + 右侧实时预览的并排视图
- [ ] 个人 Markdown 速查卡：把 12 条核心语法整理为 1 页参考卡，加入个人工具箱
🏁 小结与自测 (Milestone Checklist)
- [ ] 我理解"内容创作 vs 格式渲染分离"的工作流意识，写作时不再纠结样式
- [ ] 我掌握了 Markdown 12 条核心语法，能用纯文本写完整学术草稿
- [ ] 我会用 Pandoc 把 Markdown 一键转 DOCX/PDF/HTML，并通过
--reference-doc套用期刊模板 - [ ] 我能用 AI 协作把已有 Word 草稿快速迁移为 Markdown 格式
- [ ] 我已经在 VS Code 里配置好 Markdown 实时预览，能并排查看源码与渲染效果