在 Mac 上将 Markdown 转换为 Word(.docx)的 3 种方法

Mac 上把 Markdown 转为 Word 的 3 种方法

用 Markdown 写作很舒服。麻烦在于,对方要求你交一份 Word 文件的时候。

公司内部的申请表、学术会议的摘要、交给客户的成果物。对方不懂 Markdown,也没有必要懂。本文介绍在 Mac 上把 Markdown 转换为 Word(.docx)的 3 种方法,以及各自适合和不适合的人。

方法 1:Pandoc(免费,命令行)

Pandoc 是一款在各种文档格式之间相互转换的开源工具。如果已经装好 Homebrew,安装只需一行命令。

brew install pandoc

转换也只需一行。

pandoc 稿件.md -o 稿件.docx

标题、表格、列表和代码块都会直接转换为 Word 的样式。如果要符合公司的格式规范,可以准备一个 .docx 模板,让 Pandoc 参照它。

pandoc 稿件.md --reference-doc=模板.docx -o 稿件.docx
  • 适合的人:习惯使用终端、需要反复进行同样转换的人;想把转换写进脚本的人
  • 需要注意的地方:Mermaid 等图表无法直接变成图片(需要搭配其他工具)。为了设置中文字体、调整目录,最后可能还是要花不少时间制作模板

方法 2:在线转换服务

有很多服务,只要把文件拖进浏览器就能完成转换。论方便,没有比这更省事的了。

不过请注意,你的稿件会被上传到别人的服务器上。未发表的论文、含有客户信息的会议纪要、公司内部机密的规格书,都不应该通过这类服务转换。有些公司的规章制度也明确禁止这样做。

  • 适合的人:只是偶尔转换准备公开发表的文章的人
  • 不适合的人:需要处理机密文档的人

方法 3:使用带导出功能的编辑器

如果你用来写作的应用本身就能导出 .docx,步骤最少。既不用安装转换工具,也不用上传文件。

我们开发的 Markdocx 正是基于这一思路打造的 Mac Markdown 编辑器。

  • 应用本身即可导出 Word(.docx)和 EPUB。无需安装或设置 Pandoc,也不用命令行。还支持导出为 PDF、HTML 和 Markdown
  • 内置 Mermaid 图表。可从工具栏插入流程图、时序图、甘特图等 10 种图表,渲染完全在 Mac 上完成,不需要网络连接,也不使用外部服务
  • 实时预览。可左右或上下并排显示,双向滚动同步让两边始终停在同一段落
  • GitHub Flavored Markdown。支持表格、任务列表、删除线以及带语法高亮的代码块
  • 文件始终是纯 .md 格式。也可以与其他编辑器搭配使用

写作、实时预览、Mermaid 图表和大纲都可以不限期免费使用。前 14 天可以试用全部功能,之后一次性购买 Markdocx Premium,即可解锁 Word 导入以及导出为各种格式的功能。不是订阅制,同一 Apple 账户下的所有 Mac 都能使用。需要 macOS 26 或更高版本。

→ 了解 Markdocx 详情

如何选择

便捷程度保密性图表(Mermaid)费用
Pandoc△(命令行)◎(本地)△(需另配工具)免费
在线转换◎✕(发送到外部)△大多免费
带导出功能的编辑器◎◎(本地)◎一次性购买

简单来说:要把重复的转换自动化,就选 Pandoc;想在一个应用里完成从日常写作到提交的全部流程,就选带导出功能的编辑器。

转换时容易遇到的问题

  • 图片的相对路径:像 ![](images/fig1.png) 这样的相对路径,如果转换时找不到图片,图片就会丢失。请不要改变稿件与图片之间的相对位置
  • 表格列宽:Markdown 的表格没有列宽的概念,只能在 Word 里调整
  • 标题级别:事先决定好是用 #(H1)作为正文里的标题,还是另外设置文档标题,目录就能生成得很整齐
  • 换行的处理:按照 Markdown 的标准,单个换行不会被当作换行。写中文稿件时,选用可以切换这一行为的编辑器会更省事