Joplin · 免费开源的 Markdown 笔记与待办应用 · 中文部署与使用全指南
项目仓库： https://github.com/laurent22/joplin
开源协议：AGPL-3.0（以仓库 LICENSE 为准） · 形态：桌面（Win/macOS/Linux）+ 移动（Android/iOS）+ 终端（含 FreeBSD）+ Web Clipper · 数据格式：Markdown · 同步：Nextcloud / Dropbox / OneDrive / WebDAV / 文件系统
1 项目简介
Joplin（仓库名
laurent22/joplin）是一个免费、开源的笔记与待办应用，能把大量笔记组织进笔记本（notebook），笔记可搜索、复制、打标签、修改，支持
Markdown 格式。支持从 Evernote .enex
导入（含格式、附件、元数据），也支持纯 Markdown 导入。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Joplin |
| 仓库地址 | github.com/laurent22/joplin |
| 项目定位 | 开源 Markdown 笔记与待办应用 |
| 数据格式 | Markdown |
| 平台 | 桌面 / 移动 / 终端 |
| 同步后端 | Nextcloud / Dropbox / OneDrive / WebDAV / 文件系统 |
| 浏览器扩展 | Web Clipper（Firefox / Chrome） |
1.2 适用场景
- 想要跨平台、可自托管同步（Nextcloud / WebDAV）的开源笔记。
- 从 Evernote 迁移。
- 需要浏览器剪藏网页。
1.3 能力边界（官方口径）
- 同步时笔记本、标签等元数据保存为纯文本文件，便于检查、备份、迁移。
2 功能特性
- Markdown 笔记、待办、笔记本层级。
- 多端同步：Nextcloud / Dropbox / OneDrive / WebDAV / 文件系统。
- 端到端加密（E2EE）。
- Evernote .enex 导入。
- Web Clipper：Firefox / Chrome 剪藏网页与截图。
- 终端应用：CLI 管理。
3 官方界面预览
封面为 Joplin 官方标识。官方 README 提供全客户端截图。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/laurent22/joplin | 源码与 README |
| 官网 | joplinapp.org | 产品主页 |
| 论坛 | discourse.joplinapp.org | 社区 |
| E2EE 文档 | readme/e2ee.md | 端到端加密 |
| API 文档 | readme/api.md | 开放 API |
5 前置要求
- 桌面 / 移动 / 终端任选。
- 终端版需 Node 10+。
6 方式一：桌面应用（官方）
从 Releases 下载对应系统安装包：Windows 安装包或便携版、macOS dmg、Linux AppImage。
6.1 Linux 一键脚本
wget -O - https://raw.githubusercontent.com/laurent22/joplin/master/Joplin_install_and_update.sh | bash7 方式二：终端应用（npm）
# 先装 Node 10+
NPM_CONFIG_PREFIX=~/.joplin-bin npm install -g joplin
sudo ln -s ~/.joplin-bin/bin/joplin /usr/bin/joplin
joplin8 配置项说明
- 同步后端在应用内设置：Nextcloud / Dropbox / OneDrive / WebDAV / 文件系统目录。
- 开启 E2EE 后同步数据为加密态。
- Web Clipper 与桌面端配对使用。
9 常用运维命令
# 终端版
joplin
# 查看终端版完整文档
# https://joplinapp.org/terminal/10 常见故障排查
- 同步冲突：官方有"什么是冲突"文档（readme/conflict.md）。
- 调试模式：readme/debugging.md。
- 忘记 E2EE 密码：加密数据无法恢复，务必记牢。
11 风险与合规说明
- AGPL 许可；数据可同步到你自己的 Nextcloud / WebDAV，隐私可控。
- E2EE 密码丢失即数据丢失。
- 本文命令、链接来自官方 README 与文档，随版本可能调整，以 joplinapp.org 为准。