Clearly 是一款 SwiftUI 原生开发的 macOS Markdown 编辑器，支持双模式编辑（语法高亮 + 实时预览），内置 QuickLook 扩展可直接在 Finder 预览 .md 文件。macOS 14.0+，Swift 5.9，345 Stars。

🎤 引言

作为经常写 Markdown 的党，你肯定用过不少编辑器——Typora、Obsidian、VS Code 配插件...

但如果你想要一个纯粹、干净、原生 macOS 风格的 Markdown 编辑器，Clearly 值得关注。

它用 SwiftUI 原生开发，界面清爽，打开 .md 文件直接编辑，所见即所得。345 Stars，活跃更新中（最近一次更新是 2026 年 4 月 3 日）。

用 SwiftUI 做编辑器不多见，大多数 SwiftUI 应用都是 iOS 端的——Clearly 算是给 macOS 贡献了一个干净、原生的编辑器选择。

⭐ 核心功能

双模式编辑

  • Editor 模式：语法高亮编辑，基于 NSTextView 实现，支持 Undo、Find 面板
  • Preview 模式：WKWebView 渲染的实时预览，支持 GFM（表格、删除线、任务列表、自动链接等）
  • 一键切换：⌘1 编辑器 / ⌘2 预览

QuickLook 扩展

安装了 Clearly 后，在 Finder 里选中任意 .md 文件，按空格键就能预览内容——不需要打开 App。

原生 macOS 体验

  • SwiftUI + AppKit 混合开发
  • 支持 macOS 14.0+
  • 自动跟随系统深色/浅色模式
  • Sparkle 自动更新（直接分发版）
  • 也提供 App Store 版本

📥 安装使用

Homebrew 安装（推荐）

brew install --cask clearly

GitHub 下载

直接下载 DMG 安装包：
https://github.com/Shpigford/clearly/releases

编译源码

# 克隆项目
git clone https://github.com/Shpigford/clearly.git
cd clearly

# 生成 Xcode 项目
xcodegen generate

# 用 Xcode 打开
open Clearly.xcodeproj

# 或命令行编译
xcodebuild -scheme Clearly -configuration Debug build

依赖环境

  • macOS 14.0+
  • Xcode 16+
  • Swift 5.9

🎯 适用场景

日常笔记写作

如果你只需要一个干净、快速的 Markdown 编辑器，不想要 Obsidian 那种知识库复杂度，Clearly 刚刚好。

轻度文档编辑

打开即用，支持 GFM 格式，写 README、技术文档足够。

Finder 预览

装了 QuickLook 扩展后，任何 .md 文件都能在 Finder 里直接预览，适合整理文档目录。

🔍 对比同类工具

工具特点适合场景
Clearly轻量、原生 SwiftUI、双模式简单写作、纯编辑
Typora所见即所得、功能全复杂排版、写作
Obsidian双链知识库、插件生态PKM、知识管理
VS Code插件丰富、可编程开发环境、代码文档

日常笔记写作

如果你只需要一个干净、快速的 Markdown 编辑器，不想要 Obsidian 那种知识库复杂度，Clearly 刚刚好。

轻度文档编辑

打开即用，支持 GFM 格式，写 README、技术文档足够。

Finder 预览

装了 QuickLook 扩展后，任何 .md 文件都能在 Finder 里直接预览，适合整理文档目录。

⚠️ 注意事项

不支持双向同步

它是一个纯编辑器，不是 Obsidian 那样的双链知识库。编辑区和预览区是分开显示的，不是 Typora那种左右对照。

功能相对简单

没有插件系统、没有同步功能、没有图床管理。如果你需要这些，得用别的工具。

QuickLook 扩展需要手动开启

首次安装后可能需要在系统设置里启用扩展。

Star 增长稳定

项目目前 345 Stars，108 个 Commits，更新频率不错。如果你关心一个项目的活跃度，这个数据在同类型编辑器里算中上水平。

✅ 总结

优点：

  • SwiftUI 原生开发，界面干净清爽
  • 双模式编辑（高亮 + 预览）切换丝滑
  • QuickLook 扩展让 Finder 预览 .md 无压力
  • 支持 GFM 格式（表格、任务列表等）
  • App Store + 直接分发双版本
  • Sparkle 自动更新

缺点：

  • 功能相对简单，不适合复杂写作场景
  • 没有云同步和双向链接
  • 345 Stars，社区不算特别大

痛点场景

很多 Markdown 编辑器要么太轻（只有纯文本），要么太重（Obsidian 这种知识库），Typora 虽然好但已经收费了。Clearly 的存在填补了 macOS 原生轻量编辑器的一个小空白。

界面体验

编辑器界面简洁，工具栏在顶部，左侧是文档列表，右侧是编辑/预览区域。深色模式下文字和代码块的高亮对比清晰，长时间写作眼睛不会太累。

推荐指数：★★★☆☆

适合只需要一个"干净 Markdown 编辑器"的 macOS 用户。不臃肿、不花哨，打开就用。如果你在找 Typora 或 Obsidian 的替代品，又不想要太重的功能，Clearly 值得一试。

🔗 GitHub：https://github.com/Shpigford/clearly