Arto：GitHub 风格的 Markdown 阅读器

项目简介

Arto 是一款桌面 Markdown 阅读器，名字取自「Art of Reading」。与多数面向写作的 Markdown 工具不同，它专注阅读：在本地、离线地把 Markdown 渲染成 GitHub 的样子，排版与留白都按长时间阅读来设计。应用使用 Rust 与 Dioxus 编写，采用原生窗口与菜单，不依赖 Electron。

主要功能

GitHub 风格渲染：用 GitHub 自己的样式表呈现其方言，包括标题、表格、任务列表、脚注、自动链接、标题 slug，以及 NOTE、TIP、IMPORTANT、WARNING、CAUTION 五种提示块；代码按语言高亮并带复制按钮；YAML frontmatter 渲染成默认折叠的表格。文件在磁盘上发生变化时会就地重新渲染。样式表、高亮器、图表与公式代码都编译进二进制，渲染过程不需要网络，只有文档自身用 URL 引用的图片或视频才会被获取。

方言开关：数学、wiki 链接、上标下标、定义列表、标题属性与永久链接、智能标点、CJK 强调、裸 URL 转链接，以及原始 HTML 是过滤、透传还是转义，都可以作为开关配置。

导航与侧栏：一个面板三种视图——可放多个文件夹的文件浏览器、按天分组的已读文档、星标文档，用 ⌘1 / ⌘2 / ⌘3 切换，⌘B 显示或隐藏；未固定时悬停浮出，固定后占据文档旁的独立宽度。

装订线（gutter）：页面留白处有一条标尺标记每个标题，宽度表示标题层级，颜色表示被固定的搜索，粗细表示当前阅读位置。⌘J 把它展开成标题列表，可用方向键浏览。相对链接直接打开目标文档，⌘[ 与 ⌘] 在浏览路径上前后移动，重新打开文档会回到上次停下的位置。

查找：⌘K 像 fzf 一样用同一段查询做模糊匹配，范围包括当前文件夹下的文件、已读、星标以及所有命令（命令会显示绑定的快捷键）；⌘F 把查找框放在文档名那一行，不遮挡内容，Return 把输入保留为彩色标记，并在所有匹配的窗口中同步出现、跨会话保留。

窗口与查看器：一个文档一个窗口；一次传入多个文件则每个文件各开一个窗口；拖入文件即可打开。图表、公式和图片可以提升到独立查看器中缩放、平移、适配并复制为图片。

富内容：Mermaid 图与 KaTeX 公式就地渲染，进入视野才绘制；右键菜单可将选中内容复制为 Markdown、代码块（带或不带围栏）、表格（Markdown / CSV / TSV）、图片，也可复制文件路径与当前行号。

Lenses：可就正在阅读的文档向 Claude、Codex、Ollama 本地模型或任意 OpenAI 兼容服务提问，原文件不会被修改——逐块翻译并在右边距保留原文、从页眉打开的摘要、段落旁的笔记。在你打开某个 lens 之前不会发送任何内容。

外观与适配：内置 GitHub 主题（含调暗、高对比和色觉主题），浅色与深色可分别选择；键位提供 Default、Vim、Emacs、Clear 预设且全部可改，支持组合键；缩放级别会被记住；⌘P 通过为纸张准备的样式表打印或保存 PDF；在 macOS 上于 Finder 里按空格即可预览渲染结果。

安装与使用

macOS 可用 Homebrew 安装：

brew install --cask arto-app/tap/arto

Linux 软件包、Linux 与 Windows 的单文件二进制以及 Nix 安装方式，见仓库的 Installation 文档。

命令行会把文件交给已在运行的实例：

arto README.md

也可以把 Markdown 渲染成自包含的 HTML 页面（样式表、图表、公式全部内联），在任意浏览器中打开：

arto page README.md > README.html

导出的页面遵循你的配置，并带有 Content-Security-Policy，阻止 Markdown 中嵌入的脚本。同样的渲染器也作为独立的 arto-page 二进制提供，适合只需要输出、不需要窗口的机器。

注意事项

• 项目处于 beta 阶段，功能可能在不保证向后兼容的情况下变化。
• macOS 是主要开发与测试平台；Linux 与 Windows 构建为实验性。
• 在 macOS 上安装需要两次安全批准：DMG 文件和 app 本身都要批准。

---

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