用途：把 Markdown 文档和 Mermaid 图表通过 Joplin CLI 导入 Joplin 笔记本。适用于把研究导出到 Joplin、在 Joplin 中创建文档、为知识库生成图表、把分析结果同步到 Joplin。
主要能力：基于 Joplin CLI 的导入流程；支持列出笔记本、创建笔记本（含嵌套）、导入单个 Markdown 文件或目录、从标准输入或文件内容直接创建笔记；支持 YAML frontmatter 元数据与标签；Joplin 原生支持 Markdown 中的 Mermaid 图表。
必要用法：需先安装并配置 Joplin CLI，如 npm install -g joplin，并用 joplin version 验证。常用命令包括 joplin ls /、joplin mkbook "Notebook Name"、joplin mkbook "Parent/Child"、joplin import /path/to/file.md --notebook "Notebook Name"、joplin import /path/to/folder --notebook "Notebook Name"、joplin import /path/to/file.md --format md --notebook "Notebook Name"、joplin mknote "Note Title" --notebook "Notebook Name"。同步可按需配置，例如 joplin config sync.target 2 与 joplin config sync.2.path /path/to/sync/folder，或连接 Joplin Server/Cloud。
流程要点：先确认目标笔记本存在，不存在则创建；准备含标题、正文和可选标签的 Markdown；写入临时文件后导入；批处理可循环导入并汇总成功/失败。也可改用 Joplin Data API（默认端口 41184），需在桌面端 Options → Web Clipper 中启用。
限制：资料未提供收费、价格、平台覆盖、性能或效果数据；未提供官方文档链接与版本兼容范围；API 方式需令牌且仅提及本地 41184 端口。