目录

Markdown 笔记同步 CLI 工具

Markdown 笔记同步 CLI 工具

用 Markdown 记笔记,随处同步,不依赖任何专有格式。

问题背景

我在多台机器上用 Markdown 记笔记,想要比 Obsidian Sync 更简单的方案——只需要一个 CLI 工具,能 diff 并推送变更就够了。

命令示例

# 初始化同步配置
mnotes init --remote user@server:/notes

# 双向同步
mnotes sync

# 同步前预览差异
mnotes diff

工作原理

  1. 对本地所有 .md 文件计算哈希值
  2. 与远程哈希索引比对
  3. 推送新增/修改的文件,拉取远程独有的文件
  4. 冲突处理:两份都保留,附加时间戳后缀

依赖

  • paramiko — SSH 连接
  • watchdog — 可选,文件变更时自动同步

状态

v0.2.1 — 双机同步稳定版。三端同步是未来计划。