一、下载安装
在下载页按系统选择安装包（Windows .exe / macOS DMG / Linux AppImage），手机端去应用商店搜“Joplin”。各平台的完整安装步骤、首次启动设置、语言切换与数据目录位置见 安装与初始化手册。
二、创建第一则笔记
- 按
Ctrl + N（Mac 为Cmd + N）新建笔记，输入标题。 - 正文用 Markdown 书写，记住这几个就够用：
# 标题、**加粗**、`代码`、- [ ] 待办。 - 按
Ctrl + S保存，再按Ctrl + P全文搜索。
三、认识主界面
界面分三栏：左侧笔记本树、中间笔记列表、右侧编辑器。按 Ctrl + Shift + P 打开命令面板，几乎所有功能都能搜到。如果之前用过 Evernote 或 OneNote，会发现三栏布局并不陌生；中间的笔记列表支持排序与筛选，右侧编辑器支持实时预览。更多界面细节见 功能特性。
四、配置手机和电脑同步
国内用户最省事的方案是坚果云（WebDAV）：先在坚果云建一个 Joplin 文件夹并生成应用密码；Joplin 同步目标选 WebDAV，服务器地址填 https://dav.jianguoyun.com/dav/Joplin，账号填坚果云用户名，密码填应用密码。手机端登录同一账号即可互通。坚果云的应用密码与登录密码不同，生成后请复制保存；如果 Joplin 提示 401 认证失败，通常是应用密码填错或服务器地址多了空格。
同步前建议先开启端到端加密（设置 → 加密），并记好主密码和助记词，丢失后无法找回。
五、常见问题
Joplin 免费吗？
完全免费开源，没有功能墙。Joplin Cloud 订阅只是可选的官方同步服务。
笔记不见了怎么办？
先用 Ctrl + P 全局搜索；再检查左侧“回收站”，删除的笔记可右键恢复。
建议接着做一次备份：数据备份与恢复实战。完成同步后，打开「设置 → 加密」启用端到端加密，具体见 加密与安全。官方安装包与系统要求见 Joplin 官方系统要求；遇到下载慢的情况，可参考 国内使用指南 使用镜像加速。
Joplin 的全部源码都托管在 GitHub 官方仓库，有兴趣可以查看各平台打包脚本与发布流程；想要查看旧版本安装包，也可以到 GitHub Releases 页面下载。首次使用建议把「设置 → 常规」中的自动更新打开，这样每次发布新版本都会收到通知，减少手动检查的麻烦。日常使用中，如果发现同步后手机和电脑内容不一致，先手动按一次 Ctrl + S，再等待几秒让同步完成，多数情况都能解决。这一习惯也能减少冲突副本的产生。