Leaf 是一款 iOS / iPadOS Markdown 阅读器,通过 Git 仓库同步实现离线知识库管理。
快速开始
- 添加仓库:首次启动点「添加仓库」,填写 Git 仓库地址(GitHub / Gitee / Gitea 均可),选择认证方式(HTTPS Token 或 SSH 密钥)
- 同步:点右上角同步按钮,clone 仓库到本地(首次约 10-30 秒)
- 阅读:点击任意 .md 文件查看渲染效果
- 后续同步:再次点同步按钮拉取增量更新,或开启后台自动同步
认证方式
HTTPS(推荐)
- 在 GitHub / Gitee / Gitea 生成 Personal Access Token(PAT)
- 添加仓库时选「HTTPS」,Token 粘贴到对应字段
- 凭据经 iOS Keychain 加密存储,不上传任何服务器
SSH
- 在「设置 → SSH 密钥」导入私钥,或生成新密钥后把公钥添加到 Git 服务器
- 添加仓库时选「SSH」
支持的语法
Leaf 兼容 Obsidian 语法:
[[wikilink]]内链#tag行内标签[^1]脚注> [!note]callout 引用块(13 种类型)- [ ]任务列表- Mermaid 图表
- 数学公式(
$...$行内、$$...$$块级,KaTeX 渲染) - frontmatter 显示/隐藏
- Hugo / Jekyll 静态站图片路径(
static/img/兼容) - Gallery 相册短代码(
{{< gallery >}})
阅读功能
- 大纲抽屉:右边缘左滑拉出,点击标题跳转
- 字号调整:双指捏合放大缩小
- PDF 导出:文章页「…」菜单 → 导出 PDF
- 书签:文章页「…」菜单 → 加入书签,可添加备注
- 标签云:按词频螺旋布局展示
- 全文搜索:FTS5 全文索引,多词空格分词
常见问题
添加仓库失败,提示 SSL 证书无效?
部分自建 Gitea 实例使用自签证书。可在 Gitea 服务器配置正规 CA 证书(推荐),或使用 SSH 方式连接。
图片不显示?
Leaf 按 Markdown 中的相对路径在仓库内查找图片;Hugo / Jekyll 静态站的 static/img/ 约定路径会自动回退搜索。若图片不在仓库内(如外链已失效),则无法显示。
我的笔记会上传到服务器吗?
不会。所有数据存储在设备本地;仅在同步时从你自己的 Git 服务器拉取内容,凭据经 Keychain 加密,不经过任何第三方。
支持哪些 Git 服务?
任何标准 Git 服务:GitHub、Gitee、自托管 Gitea / GitLab 等;HTTPS(PAT)与 SSH 均可认证。
联系
使用问题或建议,请邮件联系 douboer@gmail.com。
