妙言使用指南
技术实践
Markdown
写作
介绍
Miaoyan（妙言）是一款 macOS 原生 Markdown 笔记与写作软件。
安装
- Mac APP Store 这个是需要付费的
- Homebrew
brew install --cask miaoyan - GitHub Releases 下载 DMG
使用
- 选好资料库 可以选择 ICloud 实现同步，或者是坚果云
- 认识主界面 三栏布局
- 文件夹与资料库
- 笔记列表
- 编辑器或预览区
快捷键速查表
符号说明：⌘ Command、⌥ Option、⇧ Shift、⌃ Control。
窗口与显示
| 快捷键 | 功能 |
|---|---|
⌘1 |
显示 / 隐藏侧边栏 |
⌘2 |
显示 / 隐藏笔记列表 |
⌘3 |
切换编辑与预览 |
⌘4 |
切换演示模式 |
⌘5 |
显示 / 隐藏文章目录 （只有在预览模式下可以显示目录） |
⌘\ |
切换编辑与预览分栏 |
⌘+ 或 ⌘= |
放大编辑和预览字号 |
⌘- |
缩小编辑和预览字号 |
⌘0 |
恢复默认字号 |
⌘⌥T |
窗口始终置顶 |
⌃⌘F |
进入 / 退出全屏幕 |
⌘⌥M |
全局唤起 / 隐藏妙言；可在设置中修改 |
笔记与文件夹
| 快捷键 | 功能 |
|---|---|
⌘N |
新建笔记 |
⌘⇧N |
新建文件夹 |
⌘/ |
搜索笔记 |
⌘R |
重命名笔记 |
⌘D |
复制笔记 |
⌘O |
单独打开笔记 |
⌘⇧P |
置顶 / 取消置顶 |
⌘⌥R |
在 Finder 中显示 |
⌘⇧R |
从磁盘重新载入当前笔记 |
⌘⌫ |
删除笔记 |
⌘⌥I |
显示笔记信息 |
⌘⇧H |
打开版本历史 |
⌘⌥P |
启动妙言 PPT |
⌘S |
立即保存 |
写作与排版
| 快捷键 | 功能 |
|---|---|
⌘B |
粗体 |
⌘I |
斜体 |
⌘U |
下划线 |
⌘⇧X |
删除线 |
⌘K |
插入链接 |
⌘T |
Todo |
⌘E |
行内代码 |
⌘⇧E |
代码块 |
⌘[ |
左移 / 减少缩进 |
⌘] |
右移 / 增加缩进 |
⌘⇧L |
自动排版 Markdown |
⌘⇧V |
粘贴并匹配样式 / 纯文本式粘贴 |
Tab |
展开 /table 等快捷输入；在列表中增加缩进 |
⇧Tab |
在列表中减少缩进 |
查找与常规编辑
| 快捷键 | 功能 |
|---|---|
⌘F |
在当前笔记中查找 |
⌘⌥F |
查找并替换 |
⌘G |
查找下一个 |
⌘⇧G |
查找上一个 |
⌘Z |
撤销 |
⌘⇧Z |
重做 |
⌘X / ⌘C / ⌘V |
剪切 / 复制 / 粘贴 |
⌘A |
全选 |
Esc |
退出预览搜索、演示或当前临时状态 |
部分快捷键会随当前焦点改变行为。例如在正文编辑区按 ⌘D 不会复制整篇笔记；要操作笔记本身，先点中间的笔记列表，或直接使用菜单栏和右键菜单。
小技巧
快捷键
常用的快捷键
- 新建笔记
- 新建文件夹
- 在编辑和预览之间切换
- 打开“编辑+实时预览”分栏
- 代码块
- 粗体
- 斜体
- 删除线
- 链接
- 待办
- 全局搜索
- 当前搜索
- /time 可以直接插入当前的时间 2026-07-23 21:35:04，这个还真挺好用的，特别是在写博客的 yaml 的时候。
- 自动化排版，这个功能也挺好用的。
- 预览
- 左右分栏，一边写，一边查看效果
- 表格
- Mermaid
- img
- video
- markmap 思维导图
- fold 插入可折叠区域
- task 任务列表
- 笔记之前的关联 [[2026-07-23-kaku]]
妙言 PPT
- 按
⌘⌥P启动妙言 PPT；也可以右键笔记选择“妙言 PPT”。 - 演示中按
Return打开或关闭幻灯片总览。 - 按
Esc退出。
只有包含 --- 分隔符的文档才适合作为 PPT。
自动保存与版本历史
妙言会自动保存编辑内容。当前实现会在停止输入后稍作等待再写入磁盘，以避免每敲一个字都触发文件和云盘同步；切换窗口、关闭窗口或退出应用时也会刷新待保存内容。
需要立刻保存时按 ⌘S。
查看历史版本：
- 选中笔记后按
⌘⇧H - 或右键笔记，选择“版本历史”
版本历史是恢复误改的安全网，但不能替代正式备份。历史快照保存在 Mac 的 Application Support 目录，而不是你的 Markdown 资料库中；如果只复制资料库到另一台 Mac，这些历史快照不会自动跟过去。
图片上传
妙言可以使用以下服务，我之前一直用的都是 PicGo,我配置了两个图片存储的方式。
- uPic
- PicGo
- Picsee
-
PicList
- 腾讯云 COS 这个如果访问量不大的话，一个月也就几毛钱
- Cloudflare 这个是有免费的额度，10GB，现在也够我用了
考虑到图片的隐私问题，我现在使用 Cloudflare ，因为有些照片在 腾讯云 过不了审，没法上传，但是腾讯云在国内的访问速度应该更加快一点。
MD 语法
# 一级标题
## 二级标题
加粗 **粗体** B
斜体 _斜体_ I
1. 有序列表
- [ ] 待办
> 引用
[链接文字](www.baidu.com)
`代码行`
想法
我之前也使用过妙言，不过之前是在 windows 上使用的，那个时候感觉不怎么好用，但是在 mac 上感觉这个 UI 和功能都挺好的，我还是很喜欢这个 mac 系统的。
问题
- 多窗口问题
我现在发现这个软件好像设计的没有办法打开多个窗口，让我能够对照着记录笔记，不知道是出于什么的考虑，还是我没有发现。
- 目录问题
我发现了只有在预览的模式下，可以看到目录
我现在没有找到可以查看文章目录的功能，cmd + 5 没有用
- /video 插入视频
现在插入视频发现，没有办法播放
优点
- 列表可以选择样式
- UI 好看
- 字体好看
- 支持自动排版，这个功能真的很好
- 可以导出为多种格式，HTML，PPT，PDF，图片
- 还可以查看版本历史，这个功能很牛
⌘⇧H