妙言 MiaoYan:开源、本地优先的 Mac 原生 Markdown 笔记本

妙言 MiaoYan:开源、本地优先的 Mac 原生 Markdown 笔记本

妙言 MiaoYan ↗ 是一个 Mac 上的原生 Markdown 笔记应用,作者是 tw93——写过 Mole 那款开源清理工具的同一个人。它的定位很干脆:本地优先、开源免费、不联网也能用,专心把 Markdown 编辑这一件事做扎实,没有 AI 摘要、AI 续写这些近两年笔记软件里越来越常见的功能。GitHub 上已经有 8500 多颗星,MIT 协议。

核心功能

妙言分屏编辑与预览界面,左侧文件夹与笔记列表,右侧 Markdown 源码与渲染预览左右对照

  • 本地优先,不收集数据:笔记以 Markdown 源文件形式存在你指定的本地文件夹里,不需要登录任何账号,官网强调它完全开源、不会把用户信息上传到任何地方。
  • 三栏极简设计:文件夹 + 笔记列表 + 编辑器,三栏都可以收起,支持深色模式,中文默认用开源的霞鹜文楷字体,比系统默认字体耐看不少。
  • 分屏编辑 + 实时预览:⌘\ 一键切换分屏模式,编辑和渲染结果左右对照,60fps 双向滚动同步。作者在文档里解释过没做 Typora 那种所见即所得——原生 Swift 实现 WYSIWYG 太复杂也不够可靠,分屏是权衡后的选择。
  • WikiLink 双向链接:笔记之间可以互相引用、内部跳转,适合搭建有关联的知识库,而不只是一堆零散的文件。
  • LaTeX / Mermaid / PlantUML / Markmap:数学公式、流程图、时序图、思维导图都能直接在预览里渲染出来。
  • PPT 演示模式:正文里用 --- 分隔就能把笔记直接转成幻灯片播放,笔记写完顺手就能拿去讲。
  • 自动排版 + 版本历史:保存时自动整理 Markdown 格式,内容改坏了还能翻回之前的版本看。
  • 命令行工具:装个 miao CLI,终端里 miao new、miao search、miao list 就能新建 / 搜索 / 列出笔记,写代码写累了不用切窗口。

妙言不做云同步账号体系,多端同步靠你自己选的云盘:把存储路径设成 iCloud Drive、坚果云或 Dropbox 同步的文件夹即可,iPhone 上用系统「文件」App 打开同一个云盘文件夹就能看,不用担心笔记数据存在别人的服务器上。

收费情况:Homebrew(brew install --cask miaoyan)和 GitHub Releases 下载都是免费的,MIT 开源协议,功能没有阉割。Mac App Store 版本要 88 元,代码库和免费版完全一样,官方说明是三个渠道共享同一套代码、同步更新,App Store 版换来的主要是应用商店的自动更新体验,愿意为方便付费或者想支持作者的可以选它。

用下来的感受

我平时笔记大多是技术笔记和一些临时记录,妙言的分屏模式其实很对胃口——左边敲 Markdown 语法不受干扰,右边随时能看到渲染出来的样子,不会像纯所见即所得编辑器那样偶尔被自动排版打乱思路。三栏收起来之后界面非常干净,中文用霞鹜文楷显示也确实比系统黑体耐看。

不够方便的地方也有:它只有 Mac 版,没有 iOS 或 Windows 客户端,手机上只能靠「文件」App 翻云盘里的 md 文件,谈不上「编辑」;同步也要自己动手配置,不像有道云笔记、flomo 那样开箱即用。另外 App Store 收费容易被误会成「阉割版」,实际两边是同一个东西,只是渠道不同。

如果你本来就习惯把笔记存成本地 Markdown 文件、又不想为了云同步交出数据,妙言是个做得挺干净的选择;但如果你需要多端无缝协作,或者依赖 AI 辅助写作,它大概率不是你要找的那个。