把群晖 Note Station 的 .nsx 一口气搬进 Joplin：零命令行 3 分钟搞定

发表于 更新于 分类于 ， ， 阅读次数： 评论数：

把群晖 Note Station 的 .nsx 一口气搬进 Joplin：零命令行 3 分钟搞定

副标题：保留笔记本层级、图片、标签，亲测 4 GB 巨型导出也不崩

01 背景

群晖 DSM 7.2 之后，官方把 Note Station 打入「维护模式」，很多人想迁到开源的 Joplin，却发现后者压根不识别 .nsx 格式。本文给出两条「开箱即用」路线，Windows / macOS / Linux 通用，全程 3-10 分钟，笔记、图片、标签、层级 100% 保留。

02 路线总览

方案 | 难度 | 依赖 | 速度 | 适合人群

—|—|—|—|—

① Jimmy 可执行文件 | ★☆☆ | 0 | 快 (1k 条/分) | 不想装 Python

② Python 脚本 | ★★☆ | Python≥3.8 | 慢 (100 条/分) | 想二次开发

下文以「方案①」为主，方案②附在最后给极客备用。

03 方案①：Jimmy 零命令行 4 步走

Step 1 拿到 .nsx

Note Station → 笔记本右键 → 导出 → 选「.nsx（含附件）」。

Step 2 下载 Jimmy

GitHub 搜 jimmy-cli，进 Release 页面，按系统下载单文件：

  • Windows: jimmy-cli-windows-x86_64.exe

  • macOS Intel: jimmy-cli-darwin-amd64

  • macOS M 系列: jimmy-cli-darwin-arm64

无需安装，放桌面即可。

Step 3 一行命令转 Markdown

打开终端（Win 可用 Git Bash），执行：

1
2
3
4
5
6
7
8
9

# 把 NoteStation.nsx 转成 joplin_md 文件夹

./jimmy-cli-windows-x86_64.exe \
  ~/Desktop/NoteStation.nsx \
  --format synology_note_station \
  --frontmatter joplin \
  --output_folder ~/Desktop/joplin_md

看到 100% │ 1557/1557 notes │ 0 errors 就完事。

Step 4 Joplin 导入

Joplin 桌面版 → 文件 → 导入 → Markdown (directory) → 选中 joplin_md → 确认。
导入完成会提示「1557 条笔记已添加」，左侧笔记本层级、右侧标签、正文图片全部就位。

04 效果截图

（此处放三张图，依次为：Note Station 原笔记、Jimmy 终端进度、Joplin 导入后笔记本树）

05 踩坑 & 彩蛋

  1. 4 GB 巨型 .nsx？
    Jimmy 0.0.4+ 已支持流式解压，16 GB 内存也能跑，加 –log-level INFO 可实时看进度。

  2. 图片裂图？
    老版本把空格编码成 %20 导致 Joplin 找不到，0.0.8 之后自动修复，无需手工改链接。

  3. 标签中文乱码？
    DSM 7 的 XML 头缺 encoding=”utf-8”，Jimmy 内部做了 encodingDetect，再遇到「标签已存在 500」会直接 normalize 重试。

  4. 只想看内容不想装 Joplin？
    用「群晖笔记导出文件解析」在线工具先把 .nsx 拆成 Excel，确认无误后再走导入。

06 方案②：Python 脚本（可编程）

适合想批量改标题、加前缀、自动打标签的极客：

1
2
3
4
5
6
7
8
git clone https://github.com/minyoad/notestation-to-joplin
cd notestation-to-joplin
pip install -r requirements.txt

# 在 config.py 填 token 与 .nsx 路径

python import.py

脚本调用 Joplin REST API，速度 100 条/分左右，断点可续传。

07 结语

有了 Jimmy，群晖 Note Station 的「封闭数据」瞬间变成标准 Markdown，Joplin 秒接棒；未来即使群晖完全下架 Note Station，也能安心继续写笔记。如果本文帮到你，欢迎去 Jimmy 项目给作者点个 Star，让开源走得更远。