MiaoYan version history
10 releases tracked, newest first.
V4.0.0
Jun 19, 2026- iPhone and iPad versions now available on App Store with single purchase
- iPad introduces three-column layout for folders, notes, and reading
- First iOS version supports iCloud libraries, folders, and pinned notes
- Added TOC menu and cmd+5 shortcut on macOS for navigation
1 download
V3.5.1
May 3, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V3.5.1</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>Fix toolbar buttons showing grey background bar on macOS 26</li>
<li>Fix transparent sidebar and notes list background on macOS 26</li>
<li>Faster note switching: synchronous path for loaded notes, zero delay</li>
<li>Debounced save on note switch, no longer blocking main thread</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>修复 macOS 26 上工具栏按钮出现灰色背景条的问题</li>
<li>修复侧边栏和笔记列表在 macOS 26 上背景透明的问题</li>
<li>优化笔记切换速度,已加载笔记走同步路径,切换无延迟</li>
<li>切换笔记时保存改为异步防抖,不再阻塞主线程</li>
</ol>
<hr />
<p>If you find MiaoYan useful, please consider giving it a star and recommending it to your friends.</p>
> https://github.com/tw93/MiaoYan
1 download
V3.5.0
May 2, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V3.5.0</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>Version history: right-click a note to view and restore any previous version</li>
<li>Notes are now moved to the system Trash instead of permanent deletion</li>
<li>Wikilink support: note info panel shows backlinks</li>
<li>macOS 26 glass toolbar adaptation</li>
<li>iCloud sync manager, laying the groundwork for cross-device sync</li>
<li>Open-source and App Store builds are now updated in sync, sharing the same codebase</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>新增版本历史功能,右键笔记可查看和恢复到任意历史版本</li>
<li>删除笔记改为移到系统废纸篓,误删可恢复</li>
<li>新增 Wikilink 双向链接,笔记面板展示反向链接</li>
<li>适配 macOS 26 玻璃质感工具栏</li>
<li>新增 iCloud 同步管理器,为后续多端同步打基础</li>
<li>开源版和 App Store 版恢复同步更新,共享同一份代码</li>
</ol>
<hr />
<p>If you find MiaoYan useful, please consider giving it a star and recommending it to your friends.</p>
> https://github.com/tw93/MiaoYan
1 download
V3.4.0
Apr 28, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V3.4.0</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>Now available on the Mac App Store alongside the open-source build; both versions share the same codebase</li>
<li>Split-view scroll sync upgraded to line-based algorithm, accurate even in documents with images or code blocks</li>
<li>Opening a single .md from Finder now shows all sibling files correctly</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>已上架 Mac App Store,与开源版共享同一份代码,同步更新</li>
<li>分栏滚动从比例模式升级为行级同步,图片、代码块多的文档也能精准对齐</li>
<li>从 Finder 打开单个 .md 能正确展示同目录所有文件</li>
</ol>
<hr />
<p>If you find MiaoYan useful, please consider giving it a star and recommending it to your friends.</p>
> https://github.com/tw93/MiaoYan
1 download
V3.3.0
Apr 27, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V3.3.0</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>PDF export now produces real paginated output: properly sized A4 pages with margins, heading bookmarks, and correct rendering of images and diagrams — no more endless single-column scrolls</li>
<li>Split view scroll sync upgraded to line-based algorithm, keeping editor and preview locked in position even in documents with images or code blocks</li>
<li>Symbolic link directories now work in the sidebar without duplication, and opening a single .md from Finder shows all sibling files as expected</li>
<li>Switching to large notes no longer blocks the UI — content loads asynchronously so the app stays responsive</li>
<li>Cmd+E wraps selected text as inline code; Shift+Cmd+E wraps it in a fenced code block</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>PDF 导出终于真正分页了:标准 A4 尺寸、留白边距、标题生成书签,图片和图表也能正确渲染,再也不是一张拉很长的滚动页</li>
<li>分栏滚动从比例模式升级为行级同步,含图片或代码块的文档也能精准对齐,不再偏位</li>
<li>符号链接
1 download
V3.2.0
Apr 12, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V3.2.0</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>Faster preview: Two-phase rendering shows text instantly while local images load lazily in the background, cutting perceived latency significantly</li>
<li>Open in Terminal: New Cmd+J shortcut opens the current folder in Terminal from anywhere in the app, with a folder context menu entry as well</li>
<li>Copy Path: Right-click any note to copy its full file path to the clipboard</li>
<li>Spanish localization: Full Spanish (es) UI translation covering all menus, settings, and system strings</li>
<li>Mermaid upgraded to v11.14.0, fixing subgraph edge rendering and adding new diagram features</li>
<li>Live reload fixed: Notes modified by external tools now reload correctly, including files inside symlinked directories (closes #502)</li>
<li>Launch and window fixes: Opening .md files directly from Finder no longer shows a blank window, and single-pane mode correctly r
1 download
V3.1.1
Mar 12, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V3.1.1</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>Better CLI: Expanded the miao command with search, list, open, and note viewing support, while improving path resolution and default list behavior.</li>
<li>Reload external edits: Added a quick way to reload the current note so changes made by other tools can be pulled back into the app faster.</li>
<li>Steadier sidebar: Fixed sidebar item overflow during launch and width changes, and restored the Cmd+1 shortcut for the sidebar.</li>
<li>Preview and access fixes: Fixed preview styles disappearing after idle and restored folder access in single-pane mode.</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>CLI 更顺手:扩展了 miao 命令,补全搜索、列出、打开和查看笔记等能力,并改进了路径解析与默认列表行为。</li>
<li>外部修改可重载:新增重新加载当前笔记的快捷入口,文件被其他工具改动后可以更快同步回应用。</li>
<li>侧边栏更稳定:修复窗口启动和宽度变化时侧边栏项目内容溢出的问题,并恢复 Cmd+1 侧边栏快捷键。</li>
<li>预览与访问修复:修复预览样式空闲后丢失的问题,并恢复单栏模式下的文件夹访问能力。</li>
</ol>
<hr />
<p>If you find MiaoYan useful, please consider giving it
1 download
V2.7.0
Feb 28, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V2.7.0</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>🎉 Apple Notarization complete: after investing ¥688 and writing to Tim Cook, finally done — no more "app is damaged" or "Open Anyway" hassles!</li>
<li>Preview stability upgrade: fixed intermittent blank preview and enhanced WebContent crash recovery.</li>
<li>Editing refinements: fixed IME issues in split mode, resolved system shortcut conflicts, and eliminated highlight flashing when switching notes.</li>
<li>App Store readiness: added sandbox entitlements and improved Security Scoped Bookmark persistence.</li>
<li>Internationalization polish: replaced hardcoded strings with i18n resources and improved first-launch templates.</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>Apple 公证完成:花了 688 元、给库克写信投诉才办下来,终于不会出现 App 损坏提示以及不用再去系统设置里点"仍然打开"了!</li>
<li>预览稳定性升级:修复预览偶发空白问题,增强 WebContent 进程异常后的恢复能力。</li>
<li>编辑体验优化:修复分栏模式下输入法问题,解决系统快捷键冲突,消除切换笔记时高亮闪烁。</li>
<li>App Store 能
1 download
V2.5.0
Feb 7, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V2.5.2</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>Editing experience upgrade: new Find & Replace flow in editor/preview, smoother split-view syncing, and more stable mode switching across Preview/Presentation/PPT.</li>
<li>Performance improvements for real-world writing: faster large-file typing/rendering with optimized Markdown highlighting, smarter code-block handling, and async/cancelable formatting.</li>
<li>Reliability and data safety enhancements: unified session-state routing (including export state), safer image/text replacement, improved local-image behavior in PPT, and stronger storage path persistence via Security Scoped Bookmark.</li>
<li>Polish and maintainability updates: improved localization/first-launch templates, refined window always-on-top behavior, and core architecture cleanup with modularized text pipeline and removed legacy network dependencies.</li>
</ol>
<h3>更新日志</h3>
<ol>
<li>编辑体验升级:编辑区与
1 download
V2.4.5
Jan 3, 2026<p align="center">
<a href="https://miaoyan.app/" target="_blank">
<img src="https://gw.alipayobjects.com/zos/k/t0/43.png" width="110" />
</a>
<h1 align="center">MiaoYan V2.4.6</h1>
<div align="center">A native Markdown editor for engineers.</div>
</p>
<h3>Changelog</h3>
<ol>
<li>🎉Support detecting the system language on first launch and generate more project templates.</li>
<li>Visual refinement: unified icon sizing/tints, clearer active states, better dark/light adaptability</li>
<li>Smoother preview toggle with soft reveal, plus editor selection/scroll preservation and steadier split-view resizing</li>
<li>Export overhaul: progress feedback, improved PDF/image/PPT output, dark-mode export matches preview</li>
<li>Sidebar subfolders with proper expansion state handling</li>
<li>Performance boosts: lazy-loaded note content, debounced preview updates, faster input/preview rendering</li>
<li>Search improvements and better error feedback when note saving fails</li>
<li>Reliability & privacy: save-before-reload to prevent data loss, symlink fix for single mode, telemetry removed</li>
<li>Single mode fixes: correct project selection, st
1 download