Clearly快速上手:5分钟从安装到第一篇文档,掌握这款原生Markdown编辑器

原创2026-10-14 04:58:54242 阅读

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 步就能开始写作:

  1. 启动 Clearly;
  2. 通过「文件 → 打开」选择任意 .md 文件(也可以直接双击文件让 Clearly 打开);
  3. 如果没有现成文档,按 ⌘N 新建一篇空白笔记,开始输入。

首次打开时,左侧边栏展示最近文件与常用位置,右侧是大纲(Outline)面板,底部状态栏实时显示字数与字符数。整个界面如下:

Clearly Mac 原生 Markdown 编辑器主界面:左侧文件边栏、中间实时预览与右侧标题大纲面板

如果不知道从哪里写起,菜单栏 Help → Sample Document 会打开一份内置示例文档 Shared/Resources/demo.md,覆盖表格、公式、图表、代码块等全部功能,非常适合边看边学。

第二步:熟悉两大核心视图——编辑与预览

Clearly 的核心工作流是「Edit(编辑)/ Preview(预览)」双模式:

  • ⌘1 切换到编辑模式:写作时所有 Markdown 语法(标题、加粗、斜体、链接、代码块、表格)都会实时高亮,无需等待渲染;
  • ⌘2 切换到预览模式:渲染成排好版的文档,支持 GitHub Flavored Markdown(GFM)表格、任务清单、脚注、删除线。

两种模式随时无缝切换,写作与阅读两不误:

Clearly Markdown 编辑器编辑模式与预览模式对比:左侧语法高亮源码,右侧实时渲染效果

写作时常用快捷键,建议先记住这 5 个:

快捷键 功能
⌘B / ⌘I / ⌘K 加粗 / 斜体 / 插入链接
⌘F 查找与替换(支持正则、区分大小写)
⌘P 快速切换器:按文件名秒开任意文档
⌘Shift+O 打开文档大纲,点击标题即可跳转
⌘1 / ⌘2 编辑 / 预览模式切换

进阶体验:这些功能比想象中更完整

代码块高亮与 diff 标记

写技术笔记时,代码块自带语法高亮、行号和一键复制;+/- 开头的行还会被标记为 diff 增删样式,非常适合写评审笔记或迁移文档。

浅色与深色主题自动跟随系统

编辑和预览两种模式的颜色全部随系统明暗模式自动切换,无需手动配置。渲染逻辑位于 MarkdownRenderer.swift,主题定义见 Theme.swift。

Clearly Markdown 编辑器浅色与深色模式下的编辑界面,语法高亮随主题自动切换

公式、图表与 Callout 提示框

预览模式内置 KaTeX 数学公式、Mermaid 流程图/时序图渲染,以及 NOTE、TIP、WARNING 等 15+ 种 Callout 提示框;任务清单的复选框还能直接点击切换,并同步回写源文件。

Clearly 预览界面:带行号的 Python 代码块语法高亮,以及 ⌘P 快速搜索文件切换器

隐藏神器:菜单栏 Scratchpad 便签

Mac 端还有一个杀手级功能——Scratchpad(速记本):点击菜单栏图标即可弹出悬浮小窗快速记笔记,支持全局热键呼出,历史记录自动保留,还可以「保存为文档」变成正式的 .md 文件。灵感一闪而过时,再也不用切换应用了。

Clearly 菜单栏 Scratchpad 悬浮便签窗口与右键菜单,支持全局快捷键新建便签

Finder 中空格键秒预览 Markdown

安装后 Clearly 会附带 QuickLook 扩展:在 Finder 中选中任意 .md 文件,按空格键就能直接看到渲染后的预览,效果与 App 内一致(实现见 ClearlyQuickLook/PreviewProvider.swift)。需要分享时,菜单里直接「Export PDF」导出或打印即可,分页自动处理。

上手之后的进阶路线 📚

掌握基本操作后,推荐按以下顺序深入:

总结:5 分钟回顾

  1. 安装:App Store 或 DMG 直接下载,要求 macOS 15 / iOS 17+;
  2. 打开:双击 .md 文件,或 ⌘N 新建第一篇文档;
  3. 写作:⌘B/⌘I/⌘K 快捷排版,⌘2 一键看预览效果;
  4. 增效:⌘P 快速切换文档、Finder 空格预览、菜单栏 Scratchpad 随手记。

Clearly 的设计哲学就是「保持简单」:没有花哨的数据库和同步,把 Markdown 编辑本身做到极致原生、流畅、免费。现在打开终端旁的空白文档,写下第一行 # Hello 吧 ✍️

登录后查看全文
clearly