Markdown 转 Org:把笔记搬进 Emacs Org-mode 的完整对照

我用了三年 Markdown 记笔记,去年决定搬进 Emacs。第一天就被劝退了:把一篇 Markdown 直接粘进 .org 文件,标题没折叠、粗体显示成两个原始星号、链接整段变成看得见的字面文字。问题不在 Emacs,在于这两种格式长得像、规则却不同。这篇把差异一条条摆出来,顺便讲讲怎么把整本笔记迁过去。

标题:Org 用星号数量表示层级

Markdown 的标题靠井号数量,一级是 #,二级是 ##。Org-mode 换成前导星号,星号后面跟一个空格,几颗星就是第几级:

输入(Markdown)        输出(Org)
# 项目笔记            * 项目笔记
## 快速开始          ** 快速开始
### 安装步骤        *** 安装步骤

一级一颗星,最多到六级。星号这套设计的好处是能折叠:在 Emacs 里把光标放到 ** 快速开始 上按 TAB,下面的 *** 安装步骤 会整齐收进去。Markdown 的井号做不到这种大纲折叠,这也是很多人转向 Org 的原因。在线对照可以直接打开 /zh/t/markdown-to-org/,左边粘 Markdown,右边读 Org。

强调:斜体是斜杠,粗体是单个星号

这一段最容易踩坑。Org 用单个标记做强调,跟 Markdown 的双星号习惯正好冲突:

• 粗体:Markdown 的 **粗体** 要收成单星号 *粗体*
• 斜体:Markdown 的 *斜体* 要换成斜杠 /斜体/
• 删除线:~~划掉~~ 变成加号包的 +划掉+
• 行内代码:反引号的 ` value 变成波浪号的 ~value~`

如果不改直接粘,Org 会把双星号渲染成一个字面星号加强调,把 *斜体* 当成粗体,含义全反了。

链接和图片:目标在前,描述在后

Org 的链接顺序跟 Markdown 反过来。Markdown 写 [文字](网址),Org 把网址放前面、描述放后面,套在双方括号里:

[docs](https://example.com)  →  [[https://example.com][docs]]
![logo](https://x.com/a.png) →  [[https://x.com/a.png]]

图片没有描述字段,就是裸的 [[网址]],在 Emacs 里按 C-c C-x C-v 切换内联图片就会显示出来。代码块也要换写法:三个反引号加语言名变成 #+BEGIN_SRC python 开头、#+END_SRC 结尾的源代码块,配合 Babel 还能直接执行。

待办与时间戳:Org 真正的杀手锏

迁移笔记时,最值得手动补一道的是待办。Markdown 的复选框 - [ ] 任务 在 Org 里可以提升成 TODO 标题:

* TODO 写完迁移文档
  SCHEDULED: <2026-06-15 周一>
  DEADLINE: <2026-06-20 周六>
** DONE 整理标题对照表

TODO 和 DONE 是状态关键字,放在星号标题后面;SCHEDULED 和 DEADLINE 带的尖括号时间戳会进入 Org 的议程视图,到日子自动提醒。转换工具只负责把列表行原样带过来,状态关键字和时间戳这层语义要你自己加,因为它属于 Org 独有的工作流,Markdown 里没有对应物。

迁移整本笔记到 Org-roam 的做法

我自己迁库的顺序是这样:先把每篇 Markdown 跑一遍转换,拿到干净的 Org;再按主题切成单独的 .org 文件,每个文件顶部加 #+TITLE: 和一个 Org-roam 的 ID;最后用 org-roam-node-insert 把它们用双方括号链接互相串起来。批量转换那一步交给工具最省事,一次粘贴就把标题、强调、链接、代码块全改对,我只需要专注补 TODO 状态和双链。

如果你的目标格式不是 Org 而是别的,Toolora 还有 /zh/t/markdown-to-rst/ 转 reStructuredText,以及 /zh/t/markdown-to-asciidoc/ 转 AsciiDoc,套路一样,都是浏览器本地转换,不上传内容。

整套迁移做完,我最大的感受是:Markdown 适合快速起草,Org 适合长期归档和任务管理。两边各有所长,差异摸清了,搬家就不再是手动一个个改星号的苦差。

---

Made by Toolora · Updated 2026-06-13