Leaf · Git 仓库离线阅读器

把 Git 仓库
读成一本离线的书

连接 GitHub / Gitee / Gitea,clone 即离线——

你的 Markdown 知识库随身读。

iPhone · iPad | App Store 已上架

Leaf iPad 阅读页
Obsidian 语法全兼容
数据只在你的设备上

序

Markdown 笔记散落在仓库里,手机上要么打不开,要么得开浏览器在线看—— 字体不跟手、图片加载看运气、别人家的服务器一慢就全慢。

Leaf 把整个仓库 clone 到手机里:clone 即离线,
飞机上也能翻完昨天的笔记。

离线

clone 即随身

全部文档本地存储,无网络也能读。

仓库在手,飞机上也能翻完昨天的笔记。

兼容

你的语法习惯

Obsidian 语法全支持,Hugo/Jekyll 图片路径自动回退。

不用为读个文件而改写笔记。

私有

数据只在设备上

凭据经 Keychain 硬件加密,无分析 SDK,无广告。

笔记不出设备,凭据不出钥匙串。

功能五章

一个只读的阅读器,把「读」做到位。

不做编辑、不做协作、不做云——只把 Git 仓库里的 Markdown 漂漂亮亮读出来。

第一章 · Git 仓库同步

连接你的仓库,clone 即离线。

GitHub / Gitee / 任意 Gitea 实例;HTTPS Token 与 SSH 密钥认证;fetch 快进 + 增量索引,后台自动同步。

  • clone / fetch / fast-forward 快进,本地分支始终前进到远程 tip
  • HTTPS(Personal Access Token)与 SSH 密钥认证
  • 后台自动同步(iOS 系统调度),保持本地与远程一致
  • 移除仓库时自动清除对应凭据
Leaf 仓库列表
Leaf 同步中心

仓库列表 · 同步状态

第二章 · 离线阅读与搜索

秒级全文搜索,找笔记不靠翻。

SQLite + FTS5 全文索引;搜索规则贴心中文:多词 OR、精确子串。

  • FTS5 秒级全文搜索,输入即出结果
  • 空格分词多词 OR / 无空格完整子串精确匹配
  • 搜索范围:正文 / 标题 / 标签
  • 点击结果直达文章,并高亮搜索词
Leaf 搜索
Leaf 文档列表

全文搜索 · 结果直达并高亮

第三章 · Obsidian 语法兼容

你的语法习惯,原样渲染。

wikilink、标签、脚注、callout、Mermaid、数学公式——阅读器全兼容,Hugo/Jekyll 静态站图片路径自动回退。

  • [[wikilink]] 内链与 [text](note.md) 内链导航
  • #tag 行内标签 + 标签云螺旋布局
  • callout 引用块 13 类(可折叠 · 类型着色)
  • 脚注、任务列表、Mermaid 图表、KaTeX 数学公式
  • frontmatter 显示 / 隐藏开关
  • Hugo / Jekyll static/img/ 图片路径自动回退
Leaf 渲染页

iPad · Obsidian 语法渲染(实机截图)

第四章 · 阅读体验

手指到哪里,笔记读到哪里。

大纲抽屉跟手、双指调字号、PDF 一键导出——阅读器的手感一件不缺。

  • 文档内大纲抽屉:右缘左滑跟手拉出,点击标题跳转
  • 双指捏合调整字号(HUD 实时显示)
  • 阅读进度条 + 字数统计 + 预计阅读时长
  • PDF 导出(单页长图)、书签四视图
  • 标签云螺旋布局(按词频动态展示)
  • 边缘右滑返回 + 浏览器式返回栈
Leaf 标签云
Leaf 阅读

标签云螺旋 · 阅读页

第五章 · 数据安全

笔记不出设备,凭据不出钥匙串。

无分析 SDK、无追踪、无广告;卸载即清除全部数据。

  • 所有数据存储在设备本地,不上传任何服务器
  • 凭据经 iOS Keychain 硬件加密
  • 不收集任何用户数据
  • 卸载即清除全部数据
Leaf iPad 阅读页

iPad · 沉浸阅读(实机截图)

上手指引

三步,仓库变书架。

从添加仓库到开始读,约半分钟。

一

添加仓库

首次启动点「添加仓库」,填写 Git 仓库地址(GitHub / Gitee / Gitea 均可),选择认证方式(HTTPS Token 或 SSH 密钥)。

二

同步 clone

点右上角同步按钮,clone 仓库到本地——首次约 10–30 秒,之后增量更新。

三

打开即读

点击任意 .md 文件查看渲染效果;搜索、标签、书签随手可用。

完整使用说明(认证方式 · 支持的语法 · 常见问题)→

别册 · 实机演示

一段真实录屏,看看 Leaf 在你手里的样子。

iPhone 16 Pro Max 实机录制——点按播放。

iPhone · 207 秒全程演示 引导 · 仓库 · 标签 · 搜索 · 阅读 · 书签 · PDF · 设置

演示清单(依序)

  • 首次启动引导(从设置触发,演示机已装过 App)
  • 主页仓库选择
  • 标签页:从标签打开文章
  • 搜索:从搜索结果打开文章
  • 书签:从书签打开文章,并导出 PDF 到「文件」App
  • 在「文件」App 打开导出的 PDF
  • 大纲导航(阅读页右缘左滑)
  • 关于 Leaf 页
  • 设置(阅读与外观)

App Review 审核专用演示页(英文 · 含原片下载):demo.html

后记 · 底线

你的笔记,你的设备

所有数据存储在设备本地,不上传任何服务器;
凭据经 iOS Keychain 硬件加密。

Leaf 无服务端、无分析 SDK、无广告框架;仅在你主动操作时连接你指定的 Git 服务器;卸载即清除全部数据。

阅读完整隐私政策 →