项目地址：https://github.com/tw93/miaoyan

一、项目背景：从工具到“写作体验”的转变

在笔记软件高度竞争的今天，大多数产品不断叠加功能：协作、云同步、AI、插件生态等。但与此同时，写作本身的体验却逐渐被稀释。

MiaoYan 的思路恰恰相反：

• 不追求“全能”，而是专注写作
• 不依赖云端，而是强调本地数据掌控
• 不堆叠技术，而是优化基础体验

这种理念也延续了开发者 Tw93 一贯的风格——“至繁归于至简”。  

二、核心特性：轻量但不简单

1. 原生开发，性能优先

MiaoYan 使用 Swift 6 原生构建，而非 Electron 技术栈，这带来了几个直接优势：

• 更低内存占用
• 更快启动速度
• 更流畅的交互体验

相比许多跨平台编辑器，这种选择明显偏向“系统级体验”。

2. Local-first：数据完全掌控

MiaoYan 的数据策略非常明确：

• 默认本地存储
• 支持 iCloud 同步
• 不依赖第三方服务器

这意味着：

• 数据隐私更可控
• 无网络也可使用
• 无厂商锁定风险

这种模式正是近年来“本地优先软件”趋势的重要体现。  

3. 专注写作的界面设计

MiaoYan 采用极简三栏布局：

• 左侧：文件/目录
• 中间：编辑区
• 右侧：预览

同时支持：

• 深色模式
• 高质量字体排版
• 实时预览（双向同步滚动）

整体设计目标只有一个：减少干扰，提高专注度。  

4. 面向技术写作的增强能力

虽然定位轻量，但功能并不弱：

• Markdown 全语法支持
• LaTeX 数学公式
• Mermaid 图表
• 快捷键驱动编辑

这使它不仅适合日常笔记，也适用于：

• 技术文档
• 博客写作
• 学术记录

5. CLI 与开发者友好

项目还提供命令行工具（miao）：

• 搜索笔记
• 打开文件
• 列表浏览

这对于开发者来说，是一个加分项，也体现出工具的工程化思维。

三、项目结构与工程特点

从仓库结构来看，MiaoYan 具备典型的现代开源项目特征：

• 基于 Swift + Xcode 构建
• 使用 SwiftLint / swift-format 保证代码质量
• 清晰的分支策略（dev / main）
• 完整的 Issue / PR 规范
• 自动化工作流（GitHub Actions）

同时项目强调：

• 贡献门槛低
• 文档完善
• 社区友好

这些都为长期维护打下基础。  

四、与主流 Markdown 工具的差异

可以看出，MiaoYan 并不试图替代 Obsidian，而是提供另一种选择：
更纯粹的写作工具，而不是知识管理系统。

五、适用人群

MiaoYan 更适合以下用户：

• 注重写作体验的开发者
• 喜欢 Markdown 的技术用户
• 对隐私敏感的人群
• 不需要复杂知识管理系统的人

如果你追求的是“写得顺畅”，而不是“功能最多”，它会更合适。