tw93/miaoyan

MiaoYan（妙言）是一款专为 macOS 设计的原生 Markdown 编辑器和笔记应用，由开发者 Tw93 创建。软件采用 Swift 6 开发，不依赖 Electron 等网页技术框架，注重轻量、流畅和简洁的写作体验。

与传统云笔记不同，MiaoYan 采用本地优先的设计理念，所有笔记均以 Markdown 文件形式保存在用户指定的文件夹中，不需要注册账号，也不会收集笔记内容。用户可以将笔记目录放在 iCloud Drive、坚果云或其他同步文件夹中，通过对应的云盘客户端实现跨设备同步。

软件采用文件夹、笔记列表和编辑器组成的三栏布局，并提供编辑与预览分屏模式。除了基础 Markdown 编辑功能，还支持 Wiki 双向链接、LaTeX 数学公式、Mermaid 图表、版本历史和 PPT 演示文稿模式，适合日常记录、技术写作和知识整理。

主要功能

原生 Swift 6 开发

MiaoYan 使用 Swift 6 构建，采用原生 macOS 应用架构，相比基于 Electron 的编辑器更加轻量。界面遵循 macOS 使用习惯，提供深色模式、简洁的三栏布局和专注写作体验。

本地 Markdown 文件管理

软件将笔记保存为标准 Markdown 文件，用户可以自由选择存储目录，不需要将内容上传到第三方服务器，也不会被专有数据库或云服务锁定。 这种设计便于备份、迁移和使用其他 Markdown 工具打开笔记。用户可以将存储目录设置在 iCloud Drive、坚果云或 Dropbox 等同步文件夹中，实现多设备间的文件同步。 需要注意的是，MiaoYan 本身不提供独立的云同步服务，而是由用户选择的云盘客户端负责同步。

编辑与实时预览

MiaoYan 支持 Markdown 源码编辑和分屏预览，可以在编辑时实时查看渲染效果。分屏模式提供双向滚动同步，官方介绍其滚动同步可达到 60 FPS。 用户可以使用快捷键 ⌘\\ 快速切换分屏模式，在保持 Markdown 源码编辑习惯的同时，及时检查排版效果。

Wiki 双向链接

软件支持 Wiki 风格的双向链接，可以在不同笔记之间建立关联，并通过反向链接查看哪些笔记引用了当前内容。 对于需要长期积累资料、整理知识体系和建立笔记关联的用户，这一功能可以帮助构建更加清晰的个人知识库。

LaTeX 与 Mermaid

MiaoYan 支持 LaTeX 数学公式和 Mermaid 图表，适合技术文档、学习笔记和专业内容创作。 用户可以在 Markdown 文档中编写数学表达式、流程图及其他结构化图表，不必依赖额外的编辑工具。

版本历史与自动格式整理

软件提供笔记版本历史，方便查看和恢复此前的内容。同时支持自动格式整理和键盘快捷键，减少重复的排版操作，让写作过程更加专注。

PPT 演示文稿模式

MiaoYan 支持将 Markdown 笔记转换为演示文稿，通过 --- 分隔不同幻灯片页面。用户可以使用熟悉的 Markdown 语法编写演示内容，适合制作简单的技术分享、项目介绍和学习汇报。

命令行工具

MiaoYan 还提供 CLI 命令行工具，可以在终端中创建、打开、搜索和管理笔记。 常用命令包括：

• miao new：创建笔记。
• miao open：打开笔记或文件夹。
• miao search：搜索笔记内容。
• miao list：列出笔记和文件夹。
• miao cat：在终端查看笔记内容。

对于习惯使用终端的开发者，还可以将 CLI 与自动化脚本或 AI Agent 工作流结合使用。

适合哪些用户？

• Markdown 写作者： 喜欢使用 Markdown 编写文章、技术文档和日常笔记。
• 开发者： 需要记录代码知识、项目文档、技术方案和学习资料。
• 知识管理用户： 希望通过 Wiki 链接和反向链接整理个人知识库。
• 本地优先用户： 希望笔记以普通文件形式保存在自己的设备和云盘中。
• macOS 原生应用爱好者： 更喜欢轻量、原生的 Swift 应用，而不是基于 Electron 的编辑器。

MiaoYan 妙言是什么软件？

MiaoYan（妙言）是一款由开发者 Tw93 创建的 macOS 原生 Markdown 编辑器和笔记应用，使用 Swift 6 开发。它采用本地优先的存储方式，将笔记保存为用户指定文件夹中的 Markdown 文件，不需要注册账号，也不会收集笔记内容。

MiaoYan 支持三栏笔记管理、Markdown 源码编辑、实时分屏预览、Wiki 双向链接、LaTeX 数学公式、Mermaid 图表、版本历史和 PPT 演示文稿模式。此外，还提供命令行工具，方便通过终端创建、搜索和管理笔记。

与依赖云端账户的笔记软件不同，MiaoYan 不内置云同步服务，用户可以将笔记目录放在 iCloud Drive、坚果云或 Dropbox 等文件夹中，由云盘客户端负责跨设备同步。它适合希望使用 Markdown 管理个人知识、编写技术文档和长期保存本地笔记的 Mac 用户。