+1
日增长
8,781
stars
527
forks
47
watchers
35
prs
502
issues
60
releases
README
妙言 轻灵的 Markdown 笔记本伴你写出妙言 English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français 特点 - 纯本地:笔记就是你选定文件夹里的 Markdown 文件,不收集数据,要跨设备就交给 iCloud 云盘或坚果云同步 - 专注:文件夹、笔记列表和编辑器分成三栏,带深色模式,不用维护插件 - 原生:Swift 6 开发,比网页套壳更轻,分栏预览支持 60fps 双向滚动同步 - 称手:双链、LaTeX 公式、Mermaid 图表、版本历史、自动排版和 PPT 演示都内置 - 随身:iPhone 和 iPad 版在 App Store 上,和 Mac 一次购买通用,打开同一个 iCloud 云盘笔记文件夹,在手机和平板上也能接着写 安装使用 1. App Store(推荐,一次购买 iPhone、iPad 和 Mac 都能用,自动更新): 2. Homebrew: bash brew install --cask miaoyan 3. GitHub Releases:从 GitHub Releases 下载最新 DMG(macOS 12.0+) Homebrew 与 GitHub Releases 分发的是同一个开源免费的 Mac 版本,会一直更新,只在 Mac 上写的话开源版就够了,想在手机和平板上接着写,就选 App Store 版。 用坚果云或其他云盘同步妙言 妙言不会登录 WebDAV 或网盘账号,只读写你指定的 Markdown 文件夹,跨设备同步交给 iCloud 云盘、坚果云、Dropbox 等云盘客户端。安装后在 iCloud 云盘、坚果云桌面客户端的同步目录或其他位置创建 MiaoYan 文件夹,打开设置(⌘,)把存储位置指向它,就可以开始写了。 - iPhone:在系统“文件”App 中选择同一个云盘文件夹,云盘 App 没有提供可写文件夹的话,就用 iCloud 云盘,或先在云盘 App 里把这个文件夹设为离线可用再选 - 目录检查:妙言会在切换目录前确认文件夹可读写,不可用时保留原路径,也不会把问题误报成妙言自己的云同步失败 命令行工具 bash 安装 curl -fsSL https://raw.githubusercontent.com/tw93/MiaoYan/main/scripts/install.sh | bash 使用 miao open 打开笔记或文件夹 miao new [内容] 创建新笔记 miao search 在终端搜索笔记 miao list [目录] 列出一级目录,或列出指定目录下的 Markdown miao cat 输出笔记内容 miao update 更新 CLI 分栏编辑预览模式 编辑区和预览区并排显示,按 ⌘\ 切换分栏模式,或在设置的编辑器页把默认模式设为分栏。为什么不做 Typora 式所见即所得?我想让你一直看着 Markdown 原文写,用原生 Swift 做所见即所得很重,也难保证稳定,分栏模式能专心写字,旁边就是实时预览。 使用指南 - 介绍妙言 - 使用说明和快捷键 - Markdown 语法指南 - 语法演示,含数学公式和图表 - PPT 演示模式 - 使用 --- 分隔幻灯片的演示指南 - 妙言 Agent Skill - 让 Agent 掌握妙言语法、附件、PPT 与 CLI 使用方式 运行 npx skills add tw93/MiaoYan/skills/miaoyan -g 安装官方 Skill。 支持 - 购买我做的 Mac 清理应用 Mole for Mac,是对我最直接的支持 - 如果你喜欢妙言,欢迎给它一个 Star,推荐给身边喜欢纯文本的朋友,分享出去,或者提 issue 和 PR - 我有两只猫,汤圆和可乐,如果妙言让你开心,可以请她们吃罐头 🥩 这些可爱的朋友已经投喂过了 🐱 致谢 - glushchenko/fsnotes - 项目初始结构参考 - stackotter/swift-cmark-gfm - Swift Markdown 解析器 - simonbs/Prettier - Markdown 格式化工具 - raspu/Highlightr - 语法高亮支持 - hakimel/reveal.js - PPT 演示框架 协议 MIT License
Top issues
Discussions
#565希望编辑和预览界面支持更多(自定义)颜色主题1 comments · 2026-10-08#563新版界面看着累,整体感觉奇怪1 comments · 2026-09-24#547[Feature Requests] More Persistent Preferences and Better Privacy Controls1 comments · 2026-07-25#542请问软件的字体是可配置的吗?还是固定就当前这种,现在的字体很好看但是可读性不算强1 comments · 2026-07-14#535请问这几个目录是无法删除的吗?Examples, Guide, Ideas, Notes1 comments · 2026-05-26#525求增加字数统计功能1 comments · 2026-05-07#518希望可以有iPad客户端,受够mweb了。。。1 comments · 2026-04-27#517希望可以加入目录功能1 comments · 2026-04-24
Latest release
V4.10.0 Mizutsune 🫧 V4.10.0 2026-11-15MiaoYan V4.10.0 Mizutsune 🫧
A native Markdown editor for engineers.
Changelog
Mac: Markdown files opened from Finder list under Opened in the sidebar while the library stays as it was, Move To lists folders as the sidebar nests and orders them, and [[Note|label]] links to that note
Mac: Local images in notes show again in the App Store version, and photos dragged in from Photos, Mail or a browser go straight into the note
Mac: Exported PNG, PDF and HTML no longer print the title twice, emoji in HTML show on Windows and older iOS, \$ writes a dollar sign, and an inline $ pair