Joplin 导入 Markdown 文件与目录

本文说明如何将 Markdown 文件或目录导入 Joplin 桌面端。官方文档为滚动更新页面；本文步骤是文档整理，未实机导入。

环境与准备

• Joplin 桌面端；关联软件条目记录 v3.7.21。官方导入页未标明该功能的最低版本。
• 准备一个 Markdown 文件，或包含 Markdown 文件的顶层文件夹。
• 导入前在 Joplin 笔记本列表中选择目标位置。

导入单个 Markdown 文件

1. 在 Joplin 选中目标 Notebook（笔记本）。
2. 选择 File > Import > MD - Markdown (file)。
3. 在文件选择器中选择目标 Markdown 文件并确认。
4. 返回 Joplin，检查所选 Notebook 中是否出现导入笔记并打开查看。官方说明单文件导入到当前选中 Notebook；本文未验证内容或附件。

导入整个 Markdown 目录

1. 整理好目标文件夹，并确认要选择的是其顶层目录。
2. 选择 File > Import > MD - Markdown (directory)。
3. 在文件选择器中选择该顶层目录并确认。
4. 等待完成，再检查 Joplin 中 Notebook > Subnotebook > Note 的目录映射。官方说明会保留目录结构；本文未实测层级或条目数。

常见问题与恢复

单文件进了错误的笔记本怎么办？ 官方说明其导入到当前选中的 Notebook。导入前确认目标；若已导入，先在应用中确认笔记位置，再用当前界面的移动功能整理，避免重复导入。 目录结构不符合预期怎么办？ 核对选择了顶层目录且使用 MD - Markdown (directory)，而不是单文件选项。保留原目录，可先用副本少量试导入。 是否必须逐篇导入？ 不必，官方支持导入整个 Markdown 目录。 终端应用的官方命令是什么？ 文档列出：import --format md /path/to/file.md，或 import --format md /path/to/directory/。此处仅转述，未执行。

预期结果

单文件进入导入前选中的 Notebook；目录导入将目录结构映射为 Notebook > Subnotebook > Note。完成后回到应用检查位置与内容；本文没有执行这项验证。

来源与核验范围

• Joplin 官方：Importing and exporting（2026-10-15核对：单文件和目录菜单、映射规则及命令行格式）
• Joplin v3.7.21 发布说明（关联软件版本来源） 本文为文档整理，未实测导入、目录映射、格式或附件保留；无截图。