Markleaf：本地 Markdown 笔记应用

项目简介

Markleaf 是一款面向 Android 的本地优先、极简 Markdown 笔记应用，使用 Kotlin 与 Jetpack Compose 构建。它把记录与整理作为核心：数据只保存在设备上，标准 Markdown 保证内容归属与可移植性；同步只通过用户自己选择的文件夹发生，Markleaf 本身不会同步或上传任何内容。它没有私有 vault 格式，可以指向 Obsidian、Logseq 或文本编辑器已经在用的 Markdown 文件夹。

主要功能

• 写作与预览：在行首输入 / 打开快速插入，插入标题、列表、表格、callout、wikilink、图片等标准 Markdown；支持实时预览与 Markdown 语法着色。
• Markdown 渲染：GFM 表格、复选框、引用、> [!NOTE] callout，以及代码块语法高亮。
• 编辑辅助：脚注引用与定义之间跳转、图片附件与 alt 文本编辑、选中文本或光标所在词的加粗/斜体/删除线/行内代码切换、硬件键盘快捷键、预览中的目录跳转、字体选择、专注模式、字数与阅读时间统计、笔记内查找替换。
• 组织与导航：正文里的 #tags 自动索引并支持补全；[[Title]] wikilink 与反向链接面板；Ctrl+K 快速切换；SQLite FTS 全文搜索；置顶、归档和回收站。
• 文件夹镜像同步：把每条笔记以标题命名的 .md / .txt 文件镜像到通过 SAF 选择的文件夹，可对接 Drive、Dropbox、Syncthing、OneDrive、NAS 等；重命名笔记时文件名跟随，也可开启 Keep file names 保留自己设置的文件名。Markleaf 不自行同步，而是交给同步该文件夹的外部应用。
• 打开与导出：从 ⋮ 菜单的 Open file… 或文件管理器打开外部 .md / .txt，以只读渲染方式查看，点 Save as note 后才加入笔记；支持导出单条或全部笔记为 .md，也可通过系统分享面板发送。
• 界面与无障碍：Markleaf 绿色主题与 Material You 切换、自动深色模式、平板三栏布局、11 种界面语言，以及阻止截图的选项。

安装与使用

F-Droid 安装页：https://f-droid.org/packages/com.markleaf.notes/

Google Play 页面：https://play.google.com/store/apps/details?id=com.markleaf.notes （页面标注 Updates paused）

使用方式：选择一个文件夹存放笔记。每条笔记就是一个 .md 或 .txt 文件，Markleaf 会直接读取该文件夹顶层的文件，不需要导入步骤。若要跨设备同步，用外部应用同步这个文件夹即可。

对于已有 Markdown 文件夹，放入其中的文件会在 Markleaf 回到前台时被识别为笔记。外部修改也会在回到前台时拉取，节流为每分钟一次。

注意事项

• 只读取一层文件夹：Markleaf 读取所选文件夹直接包含的文件，不会进入子目录；它按标签而不是文件夹来组织笔记。
• 编辑会重命名镜像文件：镜像文件名跟随笔记标题，因此文件名与标题不一致时，首次在 Markleaf 中保存会重命名该文件；外部 vault 中指向旧文件名的 [[links]] 可能失效。
• 深层目录或链接密集的 vault 需谨慎：如果原 vault 层级很深或链接很多，建议单独指定一个文件夹，把它当作移动端收件箱，而不是作为该 vault 的第二个编辑器。
• 同步由外部应用负责：Markleaf 不会上传或同步数据；发生冲突时，远端版本会作为独立笔记出现，不会覆盖本地编辑，也不会自动删除内容。
• 外部文件默认只读：打开外部文件后需要点 Save as note 才会加入笔记。

本作品整理自 GitHub 开源项目 jeiel85/markleaf-android，原作者 @jeiel85，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。