MarsDawn

Mac 上怎么打开 md 文件。

双击就能打开。如果你的 Mac 用文本编辑器打开，看到的是 # 和 **，而不是标题和粗体，文件没有坏：.md 文件本来就是纯文本，编辑器只是照原样显示。改用会排版 Markdown 的 app（例如 MarsDawn）打开，再把它设为默认 app，之后每个 .md 文件都会在那里打开。

.md 文件是纯文本。标题、粗体、表格和图表，都是用记号写成的：# 代表标题，** 包住粗体，直线符号画出表格，mermaid 代码块则是一张图。用纯文本编辑器打开，看到的就是这些记号。想照作者的意思读到排好的页面，就需要有东西把它排版出来。

在 Mac 上打开 md 文件

  1. 双击文件。 文件会用你的 Mac 为 .md 设定的 app 打开。如果没有任何 Markdown app，常常就是纯文本编辑器，看到的是记号，不是排好的页面。
  2. 自己选 app。 按住 Control 键点按文件，选取“打开方式”，再选 app。或者选取“文件 ▸ 显示简介”（⌘I），在“打开方式：”下选一个 app，再点按“全部更改…”，以后所有这种类型的文件都会用它打开。MarsDawn 能打开 .md、.markdown、.mdown、.mkd 和 .mkdn 文件。
  3. 不打开，直接预览。 在访达中选中文件，按空格键。装了 MarsDawn 的话，“快速查看”会显示排版后的页面，图表也在。

在 MarsDawn 里读

MarsDawn 是为 Mac 做的 Markdown 编辑器，可以在 Mac App Store 免费下载：先免费试用全部功能 14 天，之后花 USD 4.99 解锁一次就好。没有订阅，也不需要账户。需要 macOS 26 以上。

在 App Store 下载

打开 .md 文件，排好的页面就在源代码旁边：

如果这份文件是 AI 代理写的，这正是 MarsDawn 要支持的循环：代理写，你读排好的页面，代理再修改。请看首页，想让代理帮你开文件，请看给 AI 代理的 marsdawn 参考。为什么这样的阅读重要、怎么审一份计划，请看读懂代理交回来的 Markdown和五分钟审完一份代理计划。

不装 app 也行：转成 PDF

免费的 marsdawn 命令行工具，能把 Markdown 文件排版成 PDF，任何一台 Mac 都打得开。表格、数学公式、Mermaid 图表和代码高亮都会排好，而且不需要安装其他东西，连 MarsDawn app 都不用。

brew tap redtear1115/tap && brew install marsdawn
marsdawn export notes.md
open notes.pdf

export 会在 Markdown 文件旁边写出 notes.pdf，open 会用你的 PDF 查看器打开它。这个工具需要 macOS 15 以上。完整步骤和一页实际导出的结果，请看Markdown 转 PDF。

常见问题

md 文件是什么？

.md 文件是用 Markdown 写成的纯文本文件。Markdown 用简单的字符标记文本：# 是标题，** 包住的是粗体，竖线画出表格。.markdown、.mdown、.mkd、.mkdn 是同样的东西。开发者拿它写 README 和文档，AI 代理也常把计划和报告写成 .md 文件交回来。

为什么 md 文件打开是纯文本，满是 # 和 ** ？

因为它本来就是纯文本，纯文本编辑器只会照原样显示，文件没有坏。想看到标题、粗体、表格和图表，要用会排版 Markdown 的 app 打开。在 MarsDawn 里，排好的页面就在源代码旁边。

为什么打开是乱码？

乱码通常是因为文件存成 UTF-8 以外的文本编码，而打开它的 app 猜错了。解法是另存一份 UTF-8 的副本。MarsDawn 打开不是 UTF-8 的纯文本文件时会以只读方式打开，并在窗口上方的提示栏写出它当成哪种编码来读；那里的“保存为 UTF-8…”，或“文件 ▸ 保存为…”（⌥⇧⌘S），可以存出一份能编辑的 UTF-8 副本。

md 文件可以转成 PDF 吗？

可以。在 MarsDawn 选“文件 ▸ 导出为 PDF…”（⌥⌘E）或“文件 ▸ 打印…”，页面会自动分页，图表画进去，代码保留高亮，使用主题的浅色配色。不装 app 的话，免费的 marsdawn export 命令行工具能导出同样的 PDF：marsdawn export notes.md。请看导出 PDF和Markdown 转 PDF。

AI 代理写的 md 文件也能这样打开吗？

可以，MarsDawn 就是为这个做的。打开文件，排好的页面就在源代码旁边；代理改好之后，再打开来读一次。代理也可以运行 marsdawn open plan.md，在 MarsDawn 里把文件打开给你。请看读懂代理交回来的 Markdown。

接下来