Imark：macOS 原生 Markdown 阅读器

项目简介

Imark 是一款用 Swift 编写的原生 macOS Markdown 阅读器。双击 .md 文件即可看到渲染后的页面，在编辑器里保存后它会自动重新加载，在 Finder 里按空格也能直接预览渲染效果。它的评论不存进数据库，而是以 HTML 注释的形式写进 .md 文件本身，文档发给别人、提交到仓库或换一个编辑器打开，笔记都还在。所有内容都在本机处理。

主要功能

• 阅读为主，按需编辑：工具栏上有一个眼睛／铅笔开关。眼睛状态下不提供任何修改文件的操作；切到铅笔后，页面变成带行号、Markdown 高亮的纯文本编辑器，改动过的行在行号槽里有标记，⌘S 写回文件。
• 评论存进文件：选中一句话写下笔记，被引用的文字会加下划线、页边出现圆点，点击即可查看。笔记以 HTML 注释保存在文档中，并带有 quote= 引用原文，在 Vim、VS Code 或 cat 里也能看懂它指的是哪一段。支持五种颜色、编辑与删除，⌘Z 可以撤销。
• 可勾选的任务列表：点击 - [ ] 前面的方框，勾选状态会写回 .md 文件，重载后依然保留，⌘Z 可撤销。
• Quick Look 预览：在 Finder 中按空格，用与应用相同的渲染引擎显示文档，而不是原始文本。
• 实时重载：在外部编辑器保存后，视图在 300ms 内更新，并保持滚动位置，也能应对编辑器「先删后改名」的原子保存。
• 大纲与刻度轨：侧边栏列出标题并支持折叠，超过二十项时默认折叠；文档边缘每个标题对应一个刻度，悬停显示章节名，点击跳转或按住拖动浏览。
• Wiki 链接：[[note]] 会在同目录下解析，并在同一窗口打开，支持前进后退。
• 完整的 GitHub 风格渲染：表格、任务列表、脚注、front matter 头部卡片、语法高亮、Mermaid 图表、KaTeX 数学公式。
• 选中文本的操作：可以评论、在设备上翻译，或用默认浏览器搜索。
• 查找与标签页：⌘F 高亮所有命中并显示当前序号；一个窗口可开多个文档，支持 ⌘⇧[ / ⌘⇧] 切换、拖出标签页、合并所有窗口。
• 离线优先：渲染时由内容安全策略拦截外部请求，KaTeX 字体内嵌，远程图片被有意拒绝。

安装与使用

支持 macOS 14 及以上，磁盘镜像已签名并公证，打开时不会有 Gatekeeper 警告。

brew install --cask migsilva89/imark/imark

也可以下载最新版本，把 Imark.app 拖进 /Applications。

想让它成为 .md 的默认打开方式：不打开任何文档启动应用，点击 Make Imark the default for .md，或使用 Imark 菜单中的同一项。

通过 Imark ▸ Install the imark Command… 可以把 imark 链接到 /usr/local/bin（若该目录属于 root 则链接到 ~/.local/bin），随后可在终端使用：

imark notes.md            # 在已运行的实例中打开
imark notes notes.md      # 以文本形式打印文件里的笔记
imark skills              # 查看 Claude Code / Codex 的 skill 状态
imark skills install      # 安装缺失文件并更新随应用附带的副本

imark skills 系列命令不打开窗口，区分缺失、最新、过期和已被你修改的文件，不会安装插件或改动 agent 设置。退出码 1 表示存在缺失或过期文件、没有受支持的 agent 或发生错误，2 表示参数无效。

注意事项

• 网络只用于每日一次检查更新和下载新版本，可在设置中关闭。
• 编辑器未保存内容期间，实时重载会暂停，避免覆盖你正在输入的内容。
• 保存时会检查文件是否已被外部改动，若文件在读取后发生变化，保存会被拒绝并提示。
• 只想阅读的话，可以在设置中取消 Show controls for adding comments，隐藏 + 号、块高亮和评论操作，文件里已有的笔记仍然可见。
• 被引用的原文若后来被改掉，笔记会变成孤立状态：仍然可见、仍附着在原块上，但会标记为失去锚点。
• 项目使用 MIT 许可证。

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