在 macOS 上通过 Homebrew (brew) 安装 Markdown 格式化工具非常方便。根据你的需求(是想要一键美化还是检查规范),我为你推荐以下几个主流工具:
1. Prettier (最推荐:通用且美观)
Prettier 是目前最流行的代码格式化工具,它对 Markdown 的支持非常出色,能够自动处理间距、列表符号一致性、表格对齐等。
-
安装命令:
brew install prettier -
使用方法:
-
检查格式(不修改文件):
prettier --check "README.md" -
直接格式化并保存:
prettier --write "README.md" -
批量格式化当前文件夹下所有文件:
prettier --write "*.md"
-
2. mdformat (专注 CommonMark 标准)
如果你追求极致的规范化(遵循 CommonMark 标准),mdformat 是一个非常精简且强大的选择。
-
安装命令:
brew install mdformat -
使用方法:
-
直接格式化:
mdformat file.md -
批量处理:
mdformat .(递归格式化当前目录)
-
3. markdownlint-cli (检查 + 修复)
如果你不仅想格式化,还想让文档符合某些“最佳实践”(比如禁止空链接、必须有标题等),这个工具更适合。
-
安装命令:
brew install markdownlint-cli -
使用方法:
-
检查并自动修复简单问题:
markdownlint --fix "file.md"
-
4. mdfmt (Go 语言编写,类似 gofmt)
如果你习惯 Go 语言那种干净利落的格式化风格,可以尝试这个小众但高效的工具。
-
安装命令:
brew install elliotxx/tap/mdfmt -
使用方法:
mdfmt -w file.md(-w表示将结果写回文件)
总结建议
| 需求场景 | 推荐工具 | 理由 |
| 日常最省心 | Prettier | 格式化效果最漂亮,社区支持最广。 |
| 标准规范控 | mdformat | 严格遵守 CommonMark 标准,防止格式歧义。 |
| 文档质量把关 | markdownlint | 适合团队协作,强制执行统一的排版规则。 |
正文完