MiaoYan

其他资源 2025-08-05

English | 中文|日本语

妙言

轻灵的Markdown 笔记本伴你写出妙言~

特点

  • ?:纯本地使用、安全、语法高亮、黑暗模式、源文件保存、国际化、演示模式、PPT 模式、单独编辑模式、文档自动排版、文档导出、内部跳转、图床、LaTeX、Mermaid、PlantUML、Markmap 脑图
  • ?:极简的设计风格,文件夹+ 文件列表+ 编辑器方式3 列模式
  • ?:使用Swift5 原生开发,相比Web 套壳方式性能体验好
  • ?:很轻巧,纯编辑器输入体验,众多快捷键助你快人一步

首次使用

  1. 从GitHub Releases 中下载最新的dmg 安装包,macOS Big Sur 及以上版本体验更好,如安装出现问题请参考文档,此外也支持从brew install MiaoYan --cask 安装。
  2. 可以在iCloud 或根目录下创建一个MiaoYan的文件夹,打开妙言的设置,将默认存储地址修改成这个。
  3. 点击妙言左上角新增文件夹的图标,创建好自己的文档分类文件夹,就可以开始使用了。
  4. 同样假如你不习惯默认的字体,可以在设置中修改成其他的正常字体。

快捷键

窗口操作

  • command + 1:收起展开目录
  • command + 2:收起展开文档列表
  • command + 3:切换编辑和预览
  • command + 4:切换到演示模式
  • command + option + m:全局唤起/隐藏妙言

文档操作

  • command + n:新建文档
  • command + r:重命名文档
  • command + d:复制文档
  • command + o:单独打开文档
  • command + delete:删除文档
  • command + shift + n:新建文件夹
  • command + shift + l:自动排版
  • command + option + r:在Finder 中显示
  • command + option + i:显示字数等文档属性
  • command + option + p:启动妙言PPT 预览

? 此外还有很多快捷键?? ?? ?? ? 等着爱折腾的你去寻找~

妙言PPT

  1. 新朋友默认初始化会生成模版,如果是老朋友需升级到1.0,可以Copy 此文件到妙言玩一玩。
  2. 执行command + option + p 可以启动妙言PPT 预览,也可以选中文档点击右键,选择妙言PPT 打开。
  3. 只有在有--- 分隔符标志的文档中,才可启用PPT 模式,演示过程中你可以回车键预览演讲大纲,ESC 键可退出PPT 模式。
  4. 你可以使用HTML 来自定义效果,更多复杂的用法可以参考Reveal 文档。

为什么要做妙言

  • 之前有尝试过众多的笔记应用,大学时期为知笔记、印象笔记,工作时候用过Ulysses、Quiver、MWeb、Bear、Typora,种种原因,没有找到一个习惯的Markdown 应用,才有了做妙言的想法。
  • 本职为前端开发,会一点iOS 开发,爱折腾,借妙言来玩一下Swift 以及独立产品,当做一个很愉快的事情。
  • 更多介绍可见妙言- 更适合工程师用的笔记应用,很欢迎交流和建议

支持

  • 我有两只猫,假如觉得妙言让你生活更美好,可以给猫喂罐头??。
  • 如果你喜欢妙言,可以在Github Star,更欢迎推荐给你志同道合的朋友使用。
  • 可以关注我的Twitter 获取到最新的妙言更新消息,也欢迎加入Telegram 聊天群。

感谢

  • KristopherGBaker/libcmark_gfm:适用于cmark-gfm 的Swift 兼容框架
  • raspu/Highlightr:语法高亮能力
  • glushchenko/fsnotes:妙言部分初始化代码来源于此项目,很感谢作者
  • lxgw/LxgwWenKai:一款漂亮的开源中文字体,妙言将其作为默认字体
  • michaelhenry/Prettier.swift:妙言格式化能力升级成Prettier 的思路来源
  • hakimel/reveal.js:妙言PPT 底层渲染依赖此框架
  • 感谢Vercel 给妙言官网提供静态渲染能力

协议

  • 遵循MIT 协议
  • 请自由地享受和参与开源
下载源码

通过命令行克隆项目:

git clone https://github.com/tw93/MiaoYan.git