Markdown 仓库

将全部笔记导出为一篇一个的 Markdown 文件，可用 Obsidian 等软件直接打开和编辑，修改后再导回一木笔记。入口为「设置 → 导入导出 → 一木笔记 Markdown 仓库」。

操作

项目	说明
仓库目录	选择存放仓库的文件夹，首次导出或导入前需要设置
导出到仓库	将全部笔记与附件写入仓库目录
从仓库导入	扫描仓库中的 Markdown 文件，更新或新增笔记
自动导出	位于「数据同步」页，退到后台时将改动写入仓库目录

目录结构

仓库目录/
              读书笔记.md          收集箱中的笔记位于根目录
              工作/
                周会记录.md        文件夹层级即目录层级
              assets/              图片、录音、附件原文件
              .yimu/               导图、手写笔迹等专有数据

每个文件开头为 YAML 属性，包含 yimu-id、标题、创建与更新时间、文件夹、标签与置顶状态。导入时依据 yimu-id 识别对应的笔记，因此文件改名或移动目录后仍能对应到原笔记，历史记录、双链与评论不受影响。

注意

请勿修改 .yimu/ 目录中的文件，也不要删除 Markdown 文件中的 yimu-id。

导出规则

导出以当前笔记为准覆盖仓库内容，不保留历史版本；
笔记改名或移动后，旧路径上的文件会被清理；
外部修改过但尚未导入的文件，以及非一木笔记创建的文件，不会被删除，并在结果中计为未处理。此时请先导入一次再导出。

导入规则

导入前显示仓库目录与待扫描文件数，确认后开始。导入不会删除现有笔记。

情况	处理
文件无变化	跳过
仅文件有修改	更新对应笔记
文件与笔记都有修改	视为冲突，不做处理，需手动确认保留哪一份
没有 `yimu-id`	作为新笔记导入
新的目录层级	自动创建对应文件夹

文件名与所在目录以文件实际位置为准，因此可在外部软件中整理目录结构后导入。assets/ 中的附件导入时复制到应用目录。

仓库不会实时同步。在电脑上修改后，需要在手机上执行一次「从仓库导入」。