一文丝滑使用Markdown：从写作、绘图到转换为Word与PPT

文章目录

- [一、工具对比：为何 Markdown 是文档创作的"滑板鞋"？](#一、工具对比：为何 Markdown 是文档创作的“滑板鞋”？)
- [二、Markdown 极简入门：五分钟掌握核心语法](#二、Markdown 极简入门：五分钟掌握核心语法)
- [三、Markdown 编辑器：选择你的"神兵利器"](#三、Markdown 编辑器：选择你的“神兵利器”)
- - [1. 本地编辑器 (极致自由与强大)](#1. 本地编辑器 (极致自由与强大))
  - [2. 在线编辑器 (便捷与协作)](#2. 在线编辑器 (便捷与协作))
- [四、核心转换：用 Pandoc 将 Markdown 完美转换为 Word](#四、核心转换：用 Pandoc 将 Markdown 完美转换为 Word)
- - 基本使用：一键转换
  - 高级使用：自定义模板，掌控一切
- [五、用代码画图：在 Markdown 中无缝集成图表](#五、用代码画图：在 Markdown 中无缝集成图表)
- [六、更进一步：用 Markdown 制作演示文稿 (PPT)](#六、更进一步：用 Markdown 制作演示文稿 (PPT))
- - 方法一：Pandoc
  - [方法二：Marp for VS Code](#方法二：Marp for VS Code)
- 结语

今年开始注重文档的积累，尝试了很多种方式来写文档。选择一款高效、优雅的写作工具，能极大地提升创作心流和生产力，也能够提高整理文档进行记录的创作欲望。本文对markdown的使用简单总结，并介绍如何markdown文档转换为专业格式的 Word 与 PPT。

一、工具对比：为何 Markdown 是文档创作的"滑板鞋"？

写文档的过程中，我也尝试了多种文档工具，诸如word、飞书云文档、stackEdit等等。在众多的文档写作工具中，为何选择Markdown？

文档写作工具对比

特性	Microsoft Word	飞书/语雀等云文档	Markdown
核心体验	所见即所得 (WYSIWYG)	所见即所得 (云端协作)	所见即所写 (WYSIWYM)
专注度	较低。需要频繁调整格式、字体、排版，容易分心。	较高。格式控件已简化，但仍需鼠标操作。	极高。纯键盘操作，只需关注内容与结构，心流体验最佳。
"丝滑"之源	功能丰富但繁琐	协作方便但受制于平台	专注于内容本身，纯文本带来无与伦比的流畅感和控制感
版本控制	差（难以追踪具体内容变化）	较好（平台自带历史记录）	完美（可与 Git 等工具无缝集成，逐行比对差异）
转换灵活性	导出 PDF 方便，转换其他格式困难	平台内分享方便，导出格式有限	极强。可轻松转换为 HTML、PDF、Word、PPT、ePub 等

结论： Markdown 的"丝滑"体现在它的简洁 和专注 上。用简单的符号（如 #, -, **）定义文档结构，而不是在工具栏里寻找按钮。这种纯文本的特性，让它天生就具备强大的可移植性和可转换性。

更重要的是，通过后文介绍的工具，可以轻松地将 Markdown 源文件转换为任何想要的 Word 样式，实现"内容与样式分离"的先进工作流：用 Markdown 高效创作，按需输出专业格式。

二、Markdown 极简入门：五分钟掌握核心语法

Markdown易读易写，语法非常简单，以下是最常用的核心元素，只需几分钟即可掌握：

markdown 复制代码

# 这是一级标题 (相当于 <h1>)
## 这是二级标题 (相当于 <h2>)
### 这是三级标题 (相当于 <h3>)

**这是加粗的文字**
*这是倾斜的文字*
***这是加粗并倾斜的文字***

- 这是一个无序列表项
- 另一个列表项
   - 子列表项

1. 这是一个有序列表项
2. 另一个列表项

[这是一个链接](https://www.example.com)
![这是一张图片](image.jpg)

> 这是引用文字。常用于引用他人话语或突出某段内容。

如果要插入代码：
`单行代码` 使用反引号包裹。

代码块则用三个反引号包裹并可选注明语言：
	```python
		def hello_world():
		    print("Hello, World!")
	```
这是表格
| 表格 | 也很 | 简单 |
| :--- | :---: | ---: |
| 左对齐 | 居中 | 右对齐 |
| 内容 | 内容 | 内容 |

核心要点：

符号后务必加空格 ：如 # 标题、- 列表项，这是书写规范。
即时预览：几乎所有 Markdown 编辑器都提供"实时预览"功能，一侧写作，一侧即可看到渲染效果，学习起来非常直观。

掌握以上要点，即可满足基本的写作需求，上手markdown写作。

三、Markdown 编辑器：选择你的"神兵利器"

工欲善其事，必先利其器。选择一款合适的编辑器也至关重要。

1. 本地编辑器 (极致自由与强大)

Visual Studio Code + 插件 (推荐)
- 为何是神器？ VS Code 不仅仅是一个代码编辑器，通过强大的插件生态，它成为了最优秀的 Markdown 编辑器之一。
- 必备插件 ：
  - Markdown All in One：提供快捷键、目录、自动预览等全套功能。
  - Markdown Preview Enhanced：提供强大的预览功能，支持导出为 PDF、HTML 等。
  - Paste Image：允许直接粘贴剪贴板中的图片并自动插入 Markdown 链接，写作体验极大提升。
- 优点：高度可定制化，与版本控制 (Git) 无缝集成，本地文件管理方便。

2. 在线编辑器 (便捷与协作)

飞书云文档 ：
- 飞书文档完美支持 Markdown 语法。在编辑时，输入 / 即可触发命令菜单，快速插入各种 Markdown 元素（如代码块、表格等）。
- 优点：无需配置，打开即用，支持多人实时协作，非常适合团队内部文档编写。
StackEdit (https://stackedit.io/)
- 一个功能丰富的浏览器内 Markdown 编辑器。
- 优点：支持实时双向预览，可与 Google Drive、Dropbox 等网盘同步，支持直接发布到博客平台。

四、核心转换：用 Pandoc 将 Markdown 完美转换为 Word

当我们需要将写好的Markdown文档转换为正式的存档格式 .docx或者.pdf文档时，Pandoc（一个强大的文档转换瑞士军刀）是你的不二之选。

基本使用：一键转换

安装 Pandoc ：从官方下载页下载并安装。
基本命令 ：打开终端（命令行），进入你的文档目录，执行：
bash 复制代码
```
pandoc my-document.md -o my-document.docx
```
这将会把 my-document.md 转换为默认样式的 my-document.docx。

高级使用：自定义模板，掌控一切

默认模板可能不符合你公司的规范，这时可以自定义参考文档（reference.docx）。

导出默认模板：

bash 复制代码

pandoc -o custom-reference.docx --print-default-data-file reference.docx

修改模板：
- 用 Microsoft Word 打开 custom-reference.docx。
- 进入 "设计" -> "样式" 面板。
- 修改样式为期望的样式，如 "标题 1" 、"标题 2" 、"正文" 等。你可以设置中文字体、西文字体、大小、间距等。
- 修改完成后，直接保存并关闭文件。
使用自定义模板生成 Word：
bash 复制代码
```
pandoc my-document.md --reference-doc=custom-reference.docx -o my-final-document.docx
```
此时生成的 my-final-document.docx 将完全遵循你在 custom-reference.docx 中定义的样式规范，专业又美观。

也可以使用bat脚本，一键转换。以下脚本存为bat文件后，可以将当前文件夹中的markdown文档一键转换为docx

bash 复制代码

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion
for %%i in (*.md) do (
	set "input_file=%%i"
	set "output_file=%%~ni.docx"
	echo Converting "!input_file!" to "!output_file!"...
	pandoc "!input_file!" --reference-doc=\path\to\custom-reference.docx -o "!output_file!"
)
echo All conversions completed.
pause

五、用代码画图：在 Markdown 中无缝集成图表

"一图胜千言"，技术文档尤其如此。Markdown 通过扩展语法，支持以代码的方式绘制图表，这比在 Word或者visio 中拖拽形状要高效、精确得多。

Mermaid 是目前最流行的图表绘制语言，其语法简单直观，被众多平台（如 GitHub、GitLab、飞书、VS Code）原生支持。

流程图 (Flowchart) ：

markdown 复制代码

```mermaid
graph LR
    A([开始]) --> B{条件判断};
    B -- 是 --> C[执行操作];
    B -- 否 --> D([结束]);
    C --> D;
```

是否开始条件判断执行操作结束

序列图 (Sequence Diagram) ：

markdown 复制代码

```mermaid
sequenceDiagram
    参与者 Alice->>参与者 Bob: 你好 Bob，近来怎么样？
    Bob-->>Alice: 还不错！
    Bob->>第三方: 你好吗？
    第三方-->>Bob: 很好！
```

参与者 Alice 参与者 Bob Bob Alice 第三方你好 Bob，近来怎么样？还不错！你好吗？很好！参与者 Alice 参与者 Bob Bob Alice 第三方

甘特图 (Gantt) ：

markdown 复制代码

```mermaid
gantt
    title 项目开发流程
    dateFormat YYYY-MM-DD
    section 设计
    需求评审 :done, des1, 2024-01-01, 7d
    原型设计 :active, des2, after des1, 5d
    section 开发
    核心开发 :crit, dev1, after des2, 10d
```

2024-01-01 2024-01-03 2024-01-05 2024-01-07 2024-01-09 2024-01-11 2024-01-13 2024-01-15 2024-01-17 2024-01-19 2024-01-21 2024-01-23 需求评审原型设计核心开发设计开发项目开发流程

如何使用：

VS Code ：安装 Markdown Preview Mermaid Support 插件即可在预览中查看。
飞书云文档：原生支持，直接创建 Mermaid 代码块即可渲染。
Pandoc 转换 ：如需转换为 Word/PDF，可使用 --filter mermaid-filter 参数（需额外安装）将图表转换为图片嵌入。

Mermaid详细教程参考

六、更进一步：用 Markdown 制作演示文稿 (PPT)

我们甚至可以用 Markdown 来写幻灯片，告别在 PPT 里拖拽文本框的烦恼。

方法一：Pandoc

Pandoc 支持将 Markdown 转换为基于 HTML 的幻灯片（如 reveal.js）。但对于需要传统 PPTX 格式的用户，可以：

bash 复制代码

# 每个二级标题 (`##`) 是一张新幻灯片的开始
pandoc my-slides.md -o my-slides.pptx

这种方法简单，但定制化程度较低。当然，也可以像转换docx那样，自定义PPT模板。

方法二：Marp for VS Code

Marp 是一个专门用于将 Markdown 转换为幻灯片的工具和生态系统。

安装插件 ：在 VS Code 扩展商店中搜索 Marp for VS Code 并安装。

创建幻灯片 ：新建一个 .md 文件，在文件顶部添加 Marp 的指令来定义全局样式。

markdown 复制代码

---
marp: true
theme: default
headingDivider: 2
---

# 第一张幻灯片

内容...

---

## 第二张幻灯片

- 列表项
- 列表项

<!-- 在Marp幻灯片中也可以直接使用Mermaid！ -->
```mermaid
graph LR
A[想法] --> B[Markdown]
B --> C[漂亮的幻灯片]

复制代码

-   用 `---` 分隔每一张幻灯片。
-   使用 Markdown 语法编写内容。

预览与导出：编辑器右上角会出现 Marp 的预览和导出按钮，可以实时预览幻灯片效果，并直接导出为 PDF 或 PPTX 格式。

Marp 的优点：语法直观，支持主题切换，可以通过 CSS 深度定制样式，真正实现了"一份源码，多种输出"。结合 Mermaid，我们甚至可以在幻灯片中嵌入动态绘制的图表！

结语

Markdown 不仅仅是一种语法，更是一种哲学：让创作者重新专注于内容本身。它用极简的规则换来了写作的极致流畅感，而借助 Pandoc、Marp、Mermaid 等现代工具链，它又能轻松融入现有的办公流程，输出符合要求的标准化文档和图表。

附录：常用命令速查

MD -> Word (默认样式) ：pandoc input.md -o output.docx
MD -> Word (自定义样式) ：pandoc input.md --reference-doc=my-template.docx -o output.docx
导出默认参考文档 ：pandoc -o my-template.docx --print-default-data-file reference.docx
MD -> PPTX (简单) ：pandoc input.md -o output.pptx