Joplin

两种编辑模式要选对

Joplin 默认是 Markdown 编辑器（所见即所得的富文本在「切换到富文本」后启用）。Markdown 模式的好处是可移植：导出的 .md 文件在别处也能用 Git 管理。

常用语法与 Joplin 的对应：

属性（Note Properties）是 Joplin 的核心机制，写在笔记开头、单独一段 key: value 里：

title: 2024 年 Q1 复盘
tags: 工作, 复盘
created: 2024-04-01
status: 进行中

属性让笔记可被搜索语法 #status:进行中 检索，是长期积累笔记的关键。只用标签不打属性，笔记超过一千条后基本无法筛选。

附件与链接

Joplin 有两类资源：内部资源（上传的文件、笔记内部链接）和外部链接。附件默认存为内部资源，会随笔记一起同步。

易错点：

• 从网页复制粘贴时 HTML 会被转成 Markdown，复杂排版（多栏、嵌套表格、公式）常常丢失。重要内容建议以纯文本粘贴再手工加格式
• 内部链接用 :/笔记id 格式，移动笔记不会断链；但导出成单个 .md 文件时内部链接会失效，变成死链

同步：端到端加密的取舍

关键点：开启 E2EE（端到端加密）后，同步的数据在服务器上是密文。这意味着：忘记密码或加密密钥，数据永久无法找回；多设备首次同步需要在每台设备上分别输入同一个加密密钥；附件一并加密，占用空间比明文大。

不要把同步目录放在 OneDrive / Dropbox 这类自动同步文件夹里，会造成数据库文件被同步进程反复锁死甚至损坏 —— Joplin 官方明确警告过这一点。

导入导出

从别的工具迁入或在换设备时用命令行：

bashjoplin export --format md --output notes.md   # 导出为 Markdown
joplin import Evernote.enex                  # 从 Evernote 导入（enex）
joplin import ./markdown-folder              # 从 Markdown 文件夹导入

导出格式选择有坑：--format md 保留属性与内部链接，而 --format raw 是原始 Markdown、不含元数据。要迁移请用 md。

日常维护

• 笔记检索：Ctrl + P 打开命令面板，可用 type:note created:2024-01-01..2024-03-31 这类语法按时间筛
• 回收站：删除的笔记进回收站，30 天后彻底清除
• 备份：「文件 > 导出 > 导出为 JEX」生成完整归档文件（含附件），是换设备或备份的正确方式
• 插件：搜索增强视图、Markdown 表格、Todo 统计等，注意插件也会同步到其他设备

更多同步与迁移细节见 Joplin 官方帮助（在新标签页打开）。