笔记迁移篇

由于原子笔记长期不支持 Markdown,遂寻找其替代品。以下记录迁移到字节飞书的过程及导出工具 feishu2md 用法。

迁移过程

只能手动迁移,因此工作量较大。从原子笔记可以导出 .txt,飞书这边可直接批量导入,导入后开共享。图片则只能手动对照复制粘贴了。

导入的文档是无法编辑的,需要先转为飞书的在线文档格式。因此,导入前可以先转 .txt 为 .md,便于阅读一些不需要修改的文档。

1
ren *.txt *.md

使用体验

支持 Markdown 主要语法,支持 Web 端,整体观感与 Notion 类似,基本满足个人需求。然而边写边渲染,用起来不舒服,个人更喜欢 Edit / Preview 面板分离。此外,考虑尝试其日程表 / 表格等功能。

可通过在云盘中创建目录来组织文档结构。注意,直接在「我的文档库」中创建的文件属于 wiki 而非 docs,在导出时所需的权限不同。

导出工具

仅支持导出 PDF 和 Word,不能满足文档管理需要。解决方案为 Wsine/feishu2md 导出工具,当前版本 v2.4.4,直接下载 Release 即可。

根据工具主页教程进行配置,过程记录如下。

飞书应用创建

根据 README 指导配置应用权限[1],获取 AppID 及 AppSecret.

本地配置

创建环境变量及 feishu2md 配置文件,注意检查 AppID 和 AppSecret 是否配置成功。路径如下

1
$USER\AppData\Roaming\feishu2md\config.json

需要手动修改一个字段

1
"output": { "title_as_filename": true, }

下载前需在飞书侧手动开启文档或目录的外链,之后便可以 .md 格式批量下载。

1
2
# 示例链接
feishu2md dl --batch -o D:\docs\ https://share.feishu.cn/drive/folder/copy_link

下载

使用 feishu2md 下载时,图片默认保存在 static/,实测只能下载编辑过的文档,其他文件是不下载的。部分元数据也不能下载,如封面。

相反,在飞书面板中下载时,一般文件后缀可以直接下载,飞书文档则只能下载为链接。


  1. 区别于个人权限。或者,运行报错中会有详细字段名及权限开通指导,先运行再配置也可。 ↩︎