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 全文索引，多词空格分词
常见问题
Q：添加仓库失败，提示 SSL 证书无效？
部分自建 Gitea 实例使用自签证书。可在 Gitea 服务器配置正规 CA 证书（推荐），或使用 SSH 方式连接。
Q：图片不显示？
Leaf 兼容 Hugo / Jekyll 的 static/img/ 路径约定，也支持仓库内相对路径。确认图片文件在仓库中存在，路径与 Markdown 中引用一致。
Q：后台同步不触发？
iOS 后台同步由系统调度，低电量、省电模式下可能不触发。可在「设置 → 同步」调整策略（仅 Wi-Fi / 打开应用时同步）。
Q：仓库太大同步慢？
Leaf 使用浅克隆（shallow clone），只拉取最新快照不拉取完整历史。首次同步后增量更新只拉取变化部分。
Q：如何删除仓库？
「设置 → 仓库管理」左滑删除。删除会清理本地仓库文件和索引，凭据同步移除。
数据与隐私
Leaf 不收集任何用户数据，无分析 SDK，无广告。所有数据存储在设备本地，卸载即清除。详见 隐私政策 。
开源组件
Leaf 使用以下开源组件：libgit2、libssh2、OpenSSL、SwiftMarkdown、highlight.js、mermaid.js。
联系与反馈
- 邮箱：douboer@icloud.com
- GitHub： douboer
使用中遇到问题或建议，欢迎邮件联系。