Leaf 应用图标

Leaf

使用说明 · 支持与帮助

‹ 返回 Leaf 官网

Leaf 是一款 iOS / iPadOS Markdown 阅读器,通过 Git 仓库同步实现离线知识库管理。

快速开始

  1. 添加仓库:首次启动点「添加仓库」,填写 Git 仓库地址(GitHub / Gitee / Gitea 均可),选择认证方式(HTTPS Token 或 SSH 密钥)
  2. 同步:点右上角同步按钮,clone 仓库到本地(首次约 10-30 秒)
  3. 阅读:点击任意 .md 文件查看渲染效果
  4. 后续同步:再次点同步按钮拉取增量更新,或开启后台自动同步

认证方式

HTTPS(推荐)

  1. 在 GitHub / Gitee / Gitea 生成 Personal Access Token(PAT)
  2. 添加仓库时选「HTTPS」,Token 粘贴到对应字段
  3. 凭据经 iOS Keychain 加密存储,不上传任何服务器

SSH

  1. 在「设置 → SSH 密钥」导入私钥,或生成新密钥后把公钥添加到 Git 服务器
  2. 添加仓库时选「SSH」

支持的语法

Leaf 兼容 Obsidian 语法:

阅读功能

常见问题

添加仓库失败,提示 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。