FoldRender 指南
Mermaid 图和 LaTeX 公式，在手机上渲染出来
架构图和公式，通常是 README 里在手机上会退化成原始源码的那部分。FoldRender 会把它们渲染出来，用的是 APK 里自带的资源，而且渲染界面和网络完全隔断。下面讲怎么让它们显示出来，以及怎么自己确认没有在联网取任何东西。
分步操作
从 Google Play 安装
FoldRender 在 Play 商店上的名字是 FoldRender: Git Repo Reader，包名 dev.foldrender.app，免费，面向全球发行。照常安装即可 —— 不会弹出要你打开「允许来自此来源的应用」的提示，更新也会自动送达。应用声明了 minSdk 30，所以需要 Android 11 或更新的版本；如果设备低于这个版本，Play 会直接告诉你，而不是让你装上一个跑不起来的版本。
打开一个包含它们的文档
从 Git 面板克隆仓库，或者用打开文件 / 打开文件夹打开手机上已有的东西。然后在文件标签页里点那个 Markdown 文件。不用开启任何设置：mermaid 和公式是 Markdown 管线的一部分，不是一个设置项。
照你平时的写法写代码块
图表就是一个标着 mermaid 的围栏代码块。公式行内用 $…$，成块用 $$…$$。这和 GitHub、Obsidian 用的写法一样，所以现有的 README 不用改就能在这里渲染。
图太密看不清时点一下
点一下渲染好的图表，会全屏打开并可以双指缩放，在合上的手机上，这是看清一张宽时序图的唯一办法。点关闭会回到文档原来的滚动位置。
自己证明它是离线的
打开飞行模式，重新打开文档。图表和公式照样渲染。这不是缓存：mermaid 和 KaTeX 连同字体都打包在 APK 的资源里，负责渲染的 WebView 设置了 blockNetworkLoads，它的客户端对任何不是打包资源或 data URI 的地址都返回 403。没有任何配置能让它连上网络。
导出时图表完好
分享图标会打开「导出」面板。「分享为 HTML」写出一个自包含的文件，KaTeX 字体、mermaid 的渲染结果和每张图片都以 data URI 内嵌 —— 在一台从没听说过 mermaid 的电脑上也能打开。「打印 / 存为 PDF」和「分享为 PNG」来自同一份 HTML，所以三者都和屏幕上看到的一致。
FoldRender 是怎么做的
每个块一个隔离区，而不是整个应用一个 WebView
每个公式块或图表块都有自己的沙箱渲染隔离区，而不是把整个文档交给浏览器。周围的正文仍是原生 Compose —— 原生的文字选择、原生的主题、原生的滚动。
两道封锁
网络访问由 WebView 客户端拒绝：既不在打包资源目录里、也不是 data URI 的请求，一律返回 403；另外，WebView 设置里的 blockNetworkLoads 也独立地挡住了它。单靠任何一道就够了；两道都上，是有意为之。
嵌在真实的文档里
图表和公式就在应用本来就会渲染的 GFM Markdown 里 —— 带对齐的表格、任务列表、用 > [!NOTE] 写的 callout、脚注、wiki 链接，以及渲染成元数据头的 front matter。
FoldRender 做不到什么？
如实列出的清单 —— 包括已随版本发布但没有验证过的行为 —— 让你在安装前就能判断，这个版本能不能做你要做的那件事。
- 本页的中文还没有按现版应用更新，有些步骤和界面名可能对不上，请以英文版为准。页面提到的干净设备验证用的是更早的版本。
- 唯一打包的图表引擎是 mermaid。没有包含 Graphviz 和 PlantUML，因为每多一个引擎，APK 里就多几兆字节的 JavaScript，而用那些语法的设计文档更少。
- 图表的位图在滚动时不缓存。滚过一张图很远再滚回来，它会重新渲染；屏幕外的块根本不排版，这是同一笔取舍里开销小的那一半。
- 在干净设备上的验证覆盖的是 Markdown、源代码、PDF 和笔记本的渲染。这里对图表和公式隔离区的描述来自已发布的实现 —— 打包的资源、被封锁的网络 —— 而不是对每一种图表类型单独做的硬件测试。
- 没有图表编辑器。FoldRender 渲染的是你在别处写好的代码块。
在 Android 上读仓库还有哪些办法？FoldRender 和它们比怎么样？
大家真正会用的四个应用，以及把它们区分开的那一条：仓库最后在不在手机上，到了手机上有没有东西把它渲染出来。
| 工具 | 下载价格 | 从哪里获取 | 克隆到设备上 | 渲染 PDF / Jupyter 笔记本 / Markdown | 编辑器或 shell |
|---|
| FoldRender | US$0 | Google Play，全球 | 能 —— HTTPS，公开仓库可匿名 | 能 —— 原生 Compose 渲染器 | 没有，有意为之：它是阅读器，不是 IDE |
|---|
| GitHub Mobile | US$0 | Google Play 和 App Store | 不能 —— 它读的是托管在 GitHub 上的仓库 | 只有 GitHub 自己渲染的内容，需联网 | 可在 PR 里编辑文件 |
|---|
| Termux + git | US$0 | F-Droid 或 GitHub | 能 —— 真正的 git 命令行 | 不能 —— 只有终端文本 | 有，完整的 shell，任何命令行编辑器都能用 |
|---|
| MGit 1.7.0 (2023) | US$0 | 只在 F-Droid | 能 —— 克隆、拉取、推送，HTTPS 或 SSH 密钥 | 不能 | 没有 —— 它自己的页面写明不带文本编辑器 |
|---|
价格指的是下载价格。GitHub Mobile 的功能取决于你的 GitHub 套餐；Termux 和 MGit 都是自由软件。MGit 的版本和日期来自它在 F-Droid 上的页面。
FoldRender 的这些数字从哪来？
这里的每个数字都是从正式发布的版本里读出来的，或者来自本页底部列出的一手资料 —— 没有为了好看往上凑整。
- 价格：在 Google Play 上 US$0，面向全球发行。这个版本里没有计费库，没有订阅，也没有可升级的付费档。
- 当前版本：以 Google Play 页面上显示的版本为准。本页不重复写版本号，否则从发版到下一次网站更新之间它就是错的。这里的数字最后核对于 2026 年 8 月 27 日。
- 最低 Android 版本：
minSdk 30，也就是 2020 年随 Android 11 发布的 API 级别；编译和目标版本都是 API 36。 - 语法高亮：识别 65 种语言，覆盖 89 种文件扩展名，按词法对整个文件着色。
- 读取上限：单个文件最多读 32 MB，超过就标为截断；工作区全局搜索跳过大于 1.5 MB 的文件，找到 500 处匹配后就停下，不会把整栏刷满。
- 参考设备：Galaxy Z Fold 7，2025 年发布 —— 8 英寸内屏，合上时厚 8.9 mm，电池 4,400 mAh，三星标称视频播放最长 24 小时。
- 来龙去脉：Git 自 2005 年公开，所以这个应用读的磁盘格式已有 21 年历史；三星 2019 年推出第一代 Galaxy Fold，Android 有了 7 年真实的折叠屏硬件可以适配。
- 技术栈：界面用 Jetpack Compose，它的 1.0 于 2021 年发布；运行的系统从 2016 年起就支持分屏多窗口。
常见问题
- FoldRender 在 Android 上能渲染 mermaid 和 LaTeX 吗？
- 能。嵌在 Markdown 里的 mermaid 围栏代码块和 $…$ / $$…$$ 公式，通过一个隔离区渲染，背后是打包在 APK 里的 mermaid 和 KaTeX，和普通 GFM 的表格、任务列表、callout 放在一起。
- 图表需要联网吗？
- 不需要，而且这是被强制保证的，不只是用不着：负责渲染的 WebView 禁止了网络加载，它的客户端拒绝任何不是打包资源或 data URI 的请求。打开飞行模式，文档的渲染方式不会有任何变化。
- 能放大图表吗？
- 能。点一下图表会全屏打开并可以双指缩放，在合上的手机上，宽的流程图正是靠这个才能用。
- 导出会保留图表吗？
- 会。分享为 HTML 会把 KaTeX 字体、mermaid 的渲染结果和图片以 data URI 内嵌进一个文件，所以在没有任何工具链的电脑上也能渲染。PDF 和 PNG 导出来自同一份 HTML。
- Graphviz 或 PlantUML 呢？
- 没有打包。设计文档里实际出现的图表，mermaid 都能覆盖；而每多一个引擎，就是给每个用户多发几兆字节的 JavaScript。
- 支持哪些公式分隔符？
- 行内 $…$ 和成块 $$…$$ —— 就是 GitHub 和 Obsidian 已经在用的分隔符，所以为它们写的文档不用改就能在这里渲染。
- FoldRender 多少钱？
- US$0。在 Google Play 上免费，面向全球发行，版本里没有计费库，没有订阅，也没有付费档。
- FoldRender 支持哪些 Android 版本？
- Android 11 及以上。应用声明的 minSdk 是 30，也就是 2020 年随 Android 11 发布的 API 级别；编译和目标版本都是 API 36。它在 2025 年发布的 Galaxy Z Fold 7 上开发和测试。
- FoldRender 能离线用吗？
- 能，只要仓库已经在设备上。克隆和拉取需要联网；从克隆下来的仓库或选中的文件夹里阅读、搜索，以及渲染 Markdown、源代码、PDF 和 Jupyter 笔记本都不需要。登录 GitHub 是可选的，只和私有仓库有关。
- 它和 GitHub Mobile、Termux、MGit 有什么不同？
- GitHub Mobile 读的是托管在 GitHub 上的仓库，不会克隆到手机上。Termux 和 MGit 都能克隆，但克隆之后怎么渲染就交给你了 —— Termux 给你一个 shell，MGit 连文本编辑器都没有。FoldRender 通过 HTTPS 克隆，并在内屏上把克隆下来的内容渲染出来。
这些说法去哪里核对？
上面这些数字背后的一手文档，任何一条你都可以自己核对，不必听我们说。
本页最后核对于 2026-08-27。