Downright：原生 Markdown 编辑阅读器

项目简介

Downright 是一款为 macOS 打造的免费开源原生 Markdown 编辑器与阅读器，使用 Swift、AppKit 与 TextKit 2 构建。它直接打开你已有的 Markdown 文件，不需要导入资料库、维护 vault、注册账号，也不是用 WebView 伪装的桌面应用。

渲染只是对原始文本存储做装饰，不会重建或规范化文档，磁盘上的 Markdown 源码始终是权威版本。应用完全离线运行，无广告、无遥测，采用 MIT 许可证，要求 macOS 14 及以上，发布版本已签名并公证。

主要功能

• 阅读与编辑双模式：原生 CommonMark 与 GFM 渲染；Document 与 Source 视图共享阅读位置与选区，切换时不会丢失上下文。
• 精确源码：编辑的是原始 Markdown，不会被转换成私有格式。
• 丰富渲染：支持数学公式、Mermaid、表格、任务列表、callouts、图片与脚注。
• 安全的外部改动追踪：其他应用或编码助手改写已打开文件时，可在原地查看改动、保留未保存的本地编辑，并按词级别审阅差异；外部写入刷新时会保持阅读位置。
• Finder 集成：Quick Look 预览、Finder 缩略图、Spotlight 元数据。
• 导航与结构：大纲、结构缩放（structural zoom）、密度导航，可在同级文件间搜索而无需创建 vault。
• 版本与导出：本地快照与版本时间线；支持 HTML / PDF 导出、系统 Services。
• 主题：内置六套主题，默认跟随 macOS 明暗外观；可导入 VS Code 与 Shiki 主题，自定义 JSON 主题热重载。
• 阅读体验：可在 Typography 设置中调整行宽（60–120 字符或全宽，默认 70）；支持触控板左右轻扫切换模式、捏合调整字号、按住 ⇧ 滑动浏览跳转历史。
• 隐私：打开、阅读、编辑、搜索、差异对比与导出全部在本地完成，无需账号与遥测；可选的 Apple Intelligence 功能在设备端运行，默认关闭，仅接收用户选中的文本。

支持的文件扩展名：.md、.markdown、.mdown、.mkd、.mdx、.mdc、.qmd、.rmd。

安装与使用

下载应用

从 downright.cc/download 下载已签名并公证的最新版本：打开 Downright.dmg，把 Downright 拖入 Applications，首次启动时完成 Markdown 文件关联、Quick Look 与 CLI 配置。

Homebrew cask

brew tap ezzy1630/downright && brew trust --cask ezzy1630/downright/downright && brew install --cask downright

用 cask 安装后应用仍保留 Sparkle 自动更新。这是开发者 tap，免 tap 的 brew install --cask downright 需等官方 Homebrew Cask 收录后才会提供。

命令行安装

官方 shell 安装脚本会下载最新签名版本、校验发布校验和与应用签名、安装到 /Applications、注册 Finder 集成，并在可能时链接 down 与 md 命令：

curl -fsSL https://downright.cc/install | bash

已安装 Node.js 18 及以上时，也可以用 npm 启动器执行同一安装流程：

npx --yes downright-installer

常用命令

down PLAN.md                              # 打开文件
down open --line 42 --review PLAN.md      # 定位到指定行进行审阅
down open --reveal PLAN.md                # 在 Finder 中显示文档
printf '# Draft\n' | down                 # 打开管道输入的 Markdown
down read --json README.md                # 不启动应用即可查看文档信息
down outline --json README.md             # 输出文档结构
down export --format html -o out.html README.md
down check --target github Docs/sample.md # 校验渲染目标
down doctor                               # 诊断应用、CLI、Quick Look 与更新器配置

md 是 down 的别名，down --help 可查看全部命令。

自定义主题目录

~/Library/Application Support/Downright/Themes/

注意事项

• 仅支持 macOS 14 及以上系统。
• 行宽设置会同时作用于阅读配置、HTML 导出与 Quick Look 预览。
• 关闭最后一个文档时的行为可在 Settings → General 中选择「显示起始窗口」「退出 Downright」或「不做任何事」；存在未保存改动时仍会提供常规保存选项。
• 所有快捷键均可在 Settings → Keys 中修改，例如 ⌘F 查找、⌘⇧E 聚焦源码、⌘\ 分屏、⌥⌘V 版本时间线、⌘⇧K 命令面板。
• 应用为 MIT 开源项目，由独立开发者维护，无广告与应用内遥测。

---

本作品整理自 GitHub 开源项目 ezzy1630/Downright，原作者 @ezzy1630，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。