Clearly快速上手:5分钟从安装到第一篇文档,掌握这款原生Markdown编辑器
Clearly快速上手:5分钟从安装到第一篇文档,掌握这款原生Markdown编辑器
Clearly 是一款面向 Mac 和 iPhone 的原生 Markdown 编辑器:打开 .md 文件、带语法高亮地写作、一键切换实时预览,仅此而已。它基于 Swift 原生构建,没有 Electron、没有订阅、没有数据追踪(telemetry),是新手和普通用户上手 Markdown 写作的免费选择。本文带你 5 分钟内完成安装并写出第一篇文档。
安装前准备:系统要求与两种下载渠道
在开始之前,先确认你的系统满足要求:
| 平台 | 最低版本 |
|---|---|
| macOS | macOS 15(Sequoia)及以上 |
| iOS / iPadOS | iOS 17 及以上 |
Mac 端有两种安装方式,任选其一:
- Mac App Store 下载:在 App Store 搜索 "Clearly Markdown" 直接安装;
- 官网 DMG 直接下载:适合希望获得 Sparkle 自动更新体验的用户,拖入 Applications 即可。
iOS 端则从 App Store 安装 Clearly,之后可以从系统「文件」App 直接打开任意 .md 文件。
💡 提示:如果电脑上是直接下载版,应用内置 Sparkle 自动更新,无需手动检查新版本。
第一步:打开你的第一篇 Markdown 文档
安装完成后,只需 3 步就能开始写作:
- 启动 Clearly;
- 通过「文件 → 打开」选择任意
.md文件(也可以直接双击文件让 Clearly 打开); - 如果没有现成文档,按 ⌘N 新建一篇空白笔记,开始输入。
首次打开时,左侧边栏展示最近文件与常用位置,右侧是大纲(Outline)面板,底部状态栏实时显示字数与字符数。整个界面如下:
如果不知道从哪里写起,菜单栏 Help → Sample Document 会打开一份内置示例文档 Shared/Resources/demo.md,覆盖表格、公式、图表、代码块等全部功能,非常适合边看边学。
第二步:熟悉两大核心视图——编辑与预览
Clearly 的核心工作流是「Edit(编辑)/ Preview(预览)」双模式:
- ⌘1 切换到编辑模式:写作时所有 Markdown 语法(标题、加粗、斜体、链接、代码块、表格)都会实时高亮,无需等待渲染;
- ⌘2 切换到预览模式:渲染成排好版的文档,支持 GitHub Flavored Markdown(GFM)表格、任务清单、脚注、删除线。
两种模式随时无缝切换,写作与阅读两不误:
写作时常用快捷键,建议先记住这 5 个:
| 快捷键 | 功能 |
|---|---|
| ⌘B / ⌘I / ⌘K | 加粗 / 斜体 / 插入链接 |
| ⌘F | 查找与替换(支持正则、区分大小写) |
| ⌘P | 快速切换器:按文件名秒开任意文档 |
| ⌘Shift+O | 打开文档大纲,点击标题即可跳转 |
| ⌘1 / ⌘2 | 编辑 / 预览模式切换 |
进阶体验:这些功能比想象中更完整
代码块高亮与 diff 标记
写技术笔记时,代码块自带语法高亮、行号和一键复制;+/- 开头的行还会被标记为 diff 增删样式,非常适合写评审笔记或迁移文档。
浅色与深色主题自动跟随系统
编辑和预览两种模式的颜色全部随系统明暗模式自动切换,无需手动配置。渲染逻辑位于 MarkdownRenderer.swift,主题定义见 Theme.swift。
公式、图表与 Callout 提示框
预览模式内置 KaTeX 数学公式、Mermaid 流程图/时序图渲染,以及 NOTE、TIP、WARNING 等 15+ 种 Callout 提示框;任务清单的复选框还能直接点击切换,并同步回写源文件。
隐藏神器:菜单栏 Scratchpad 便签
Mac 端还有一个杀手级功能——Scratchpad(速记本):点击菜单栏图标即可弹出悬浮小窗快速记笔记,支持全局热键呼出,历史记录自动保留,还可以「保存为文档」变成正式的 .md 文件。灵感一闪而过时,再也不用切换应用了。
Finder 中空格键秒预览 Markdown
安装后 Clearly 会附带 QuickLook 扩展:在 Finder 中选中任意 .md 文件,按空格键就能直接看到渲染后的预览,效果与 App 内一致(实现见 ClearlyQuickLook/PreviewProvider.swift)。需要分享时,菜单里直接「Export PDF」导出或打印即可,分页自动处理。
上手之后的进阶路线 📚
掌握基本操作后,推荐按以下顺序深入:
- 阅读 Shared/Resources/getting-started.md:内置的新手引导文档,讲清边栏、大纲与快捷键;
- 查看 docs/markdown-rendering-architecture.md:了解预览渲染管线的完整架构;
- 翻看 CHANGELOG.md 与 CHANGELOG-iOS.md:两个平台独立发版,这里记录了每个版本的新功能;
- 想改预览样式或高亮规则?核心代码都集中在 ClearlyCore/Sources/ClearlyCore/Rendering/ 目录,Mac、iOS 和 QuickLook 三个端共享同一套渲染器。
总结:5 分钟回顾
- 安装:App Store 或 DMG 直接下载,要求 macOS 15 / iOS 17+;
- 打开:双击
.md文件,或 ⌘N 新建第一篇文档; - 写作:⌘B/⌘I/⌘K 快捷排版,⌘2 一键看预览效果;
- 增效:⌘P 快速切换文档、Finder 空格预览、菜单栏 Scratchpad 随手记。
Clearly 的设计哲学就是「保持简单」:没有花哨的数据库和同步,把 Markdown 编辑本身做到极致原生、流畅、免费。现在打开终端旁的空白文档,写下第一行 # Hello 吧 ✍️




