惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

The GitHub Blog
The GitHub Blog
博客园 - 三生石上(FineUI控件)
V
V2EX
博客园 - 司徒正美
小众软件
小众软件
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
T
Tailwind CSS Blog
Last Week in AI
Last Week in AI
雷峰网
雷峰网
月光博客
月光博客
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Apple Machine Learning Research
Apple Machine Learning Research
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
S
SegmentFault 最新的问题
美团技术团队
Hugging Face - Blog
Hugging Face - Blog
WordPress大学
WordPress大学
宝玉的分享
宝玉的分享
爱范儿
爱范儿
博客园 - 聂微东
量子位
J
Java Code Geeks
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
Vercel News
Vercel News

少数派

派早报:Google 发布 Fitbit Air 等 - 少数派 「新人报到」確認需求,再開始 - 少数派 从 SOLO 独立开发者社区,我看到了越来越多开发者开始做自己的产品 - 少数派 我怎么管理那些"不常做,但总会忘"的生活事项 - 少数派 人形机器人量产元年,数据才是具身智能的“生死线” - 少数派 BuhoLaunchpad 高度还原 Mac 启动台:开发历程与思考 - 少数派 五年陪伴依然不舍,DIY 换壳后让罗技 MX Master 3 继续服役 - 少数派 新玩意 240|少数派的编辑们最近买了啥? - 少数派 一日一技|为什么你应该关闭 iOS 的键盘声音 - 少数派 我做了个插件和 Skills,一键提取任何网站的设计规范 Design.md - 少数派 住在三四线城市的你,该开始录播客了 - 少数派 甘南秘境,大白高国 - 少数派 AI的审美:谁让把我变成川内倫子 - 少数派 返工怎能不烦恼,打工人片单总有一部是你的「嘴替」 - 少数派 为了让「上厕所」更健康,我做了一个小工具 - 少数派 AI + Skill,能够让生成的文章去除 AI 味吗? - 少数派 新玩意|韶音OpenDots ONE 耳夹式耳机 - 少数派 《美满》| 在每一个春天的晚上相爱(362) - 少数派 新玩意|优篮子 PS01 MagSnap 磁吸支架 - 少数派 自我整合手记 | 我开始早睡了:用稳定规则,为自由托底 - 少数派 用龙虾(OpenClaw)两个多月,我最深的12个体会 - 少数派 听歌时间到,12 张你可能错过的 2025 华语乐坛好专辑 - 少数派 承诺能追吗 - 少数派 macOS 26启动台没了? 我做了个不一样的App启动器 - Keboard - 少数派 《四海为家的人》| INTJ对话INTJ(361) - 少数派 你发过的那些黑历史,是时候一次清干净了 - 少数派 新玩意:安安静静玩,越玩越专注:计客密码机 - 少数派 iPad 用户首次体验 Android 平板:vivo Pad6 Pro - 少数派 数据逻辑强 - 少数派 极北行+ | 一路向北,探访日本至北之地 | 001 - 少数派
如何从 Notion 批量导出 Markdown? - 少数派
2020-07-17 · via 少数派

Matrix 精选

Matrix 是少数派的写作社区,我们主张分享真实的产品体验,有实用价值的经验与思考。我们会不定期挑选 Matrix 最优质的文章,展示来自用户的最真实的体验和观点。

文章代表作者个人观点,少数派仅对标题和排版略作修改。


没有导出的后顾之忧时,Notion 就变得更可爱了。

痛点

介绍了 Roam Research 后,有小伙伴问我是否用过 Notion。

用过。

刚才找了找,还有来自于 2017 年 5 月的 Notion 笔记记录。

简单看了一下,这三年多以来,我用 Notion 写了不少笔记,也采集了很多网页内容。

但是,我算不上 Notion 的重度用户。因为有个痛点,我从来也没有解决。就是导出

我用笔记工具,很多时候都需要输出成文章发布。发布的时候,我得用 Markdown。

很不幸,在 Notion 上,这个过程,从来就没有痛快过。

虽然 Notion 从很早就提供 Markdown 导出,还包括子页面。但是导出来的结果,总是无法令我满意。

例如子页面仅仅是指实质的上下层级关系,而链接的页面不包含在导出结果中。

因为喜欢卡片式笔记,拼接移动,我是希望 notion 能够像 Scrivener 一样,输出的时候把这些卡片拼完整输出的。

但是,这基本上做不到。

导出的标题,只要是中文,就都是「无标题」(Untitled)。

内嵌照片,要么因为是链接,导出过程根本就没有下载。

要么下载之后,也无法正常在 Markdown 编辑器里面显示。

有的就没有按照图片来对待:

而即便是被下载下来的图片,有的也没有合适的扩展名。

但是如果预览,你会发现它就是张图啊!

由于不能在输出的时候,保持完整性和可用性,我就不敢再把更多的笔记迁移进来,同时也不愿意在 Notion 上写更多的文章了。

解决

前些日子,我因为写研究报告的需要,从 Notion 里批量导出一些笔记,放入「第二大脑」里面进行处理。

上网查资料的时候,我突然发现了这个 Github 项目,叫做 notion2md

它已经做成了 Python 的软件包,可以调用 Notion 的 API,帮助用户导出为更妥帖的 markdown 格式。

你只需要使用:

pip install notion2md

安装之后,就能执行:

python -m notion2md

你需要指定输出文件名称,自己的 token_v2 身份验证信息,以及来源 notion 链接,就能在本地输出导出的 Markdown 结果了。

但是,这个工具,有以下几个问题:

首先,你需要安装 Python 和依赖模块;

其次,对于每一个要导出的单元,你都需要重新执行一遍。作为单一文章输出,这还好。但是如果你是打算进行数据备份或者迁移,那就太麻烦了;

另外,你需要在后期手动进行图片路径的处理,删去多余层级。这应该是一个 bug。

正因为如此有上述的问题,所以目前该工具的 Github 页面上,只有寥寥 4 颗 star,其中一颗还是我打上去的。

我希望的是,把上述问题解决,而且最好做成 Web App ,这样大家都可以直接拿来即用。

改进

经过半天的折腾,我终于用 Python 和 Streamlit 完成了这个制作过程。然后又花时间做了个使用说明出来。

这个项目的 Github 页面在这里

你只需要按照上面列出的步骤,一步步来就行。考虑到部分同学阅读英文不是很流畅,我这里翻译了一份中文步骤给你。

步骤

请按照以下简单步骤操作。

第一步,打开这个链接,你会看到 App 界面。

第二步,获取你的token_v2(你的身份认证码),并将其输入到第一个文本框中。你可以通过阅读这个图文教程来学习如何取得你的token。

第三步,将所有要导出的页面都移动或者链接到一个新页面。例如我这里新建了一个「准备输出」。

第4步,复制新页面的链接,粘贴到第二个文本框中,然后按回车键。

第五步,你会看到一个名为 "export" 的新按钮出现。点击它。

第6步,运行一会儿(视你要导出的内容多少,尤其是图片大小等因素而定),当你看到网页上显示了一个名为「点击下载」的新链接,点击它并下载压缩文件。解压后,你会发现所有的Markdown文件以及图片。

这是子文件夹下面的图片:

第七步(可选),将解压后的文件夹拖到 Obsidian 或者 Zettlr 的根目录下,然后正常浏览图文。

所有页面的标题,都被保留为 Markdown 文件的名称,对中文同样支持。这样你在后面依照标题建立双向链接,就会变得非常容易。

另外说明一下,因为 API 的功能限制,目前该 App 尚不能准确处理 Notion 的 database (数据库),而只能对普通的页面(Page)进行导出。

不过各种 Media 类型都是可以处理的。只不过只有图片进行了本地化输出,其余的类型,例如视频、pdf 等都保留了原先的链接。你可以通过链接跳转访问。

对于我来说,主要是写论文和图文类教程,因此这些其他类型的多媒体数据,本来也是不需要输出的,所以刚好合适。

感受

有了这个比较靠谱的批量导出功能以后,我觉得 Notion 变得更加可爱了。

至少,我写东西的时候,可以不用考虑将来导出之后一通检查、调整、修改名称等等繁琐问题了。没有了后顾之忧,用起来感觉更加轻松愉快。

我可以更加随心所欲在 Notion 里面采集和进行快速记录,并且进行卡片笔记的撰写和整合。

已知问题

经过多位来自于全球各地的小伙伴帮我测试后,发现运行起来功能比较正常。

目前主要反馈得来的问题,是连接可能不稳定。

没办法,咱们用的是 Heroku 免费托管,没交钱。人一多,并发就会是个问题。而且不同电信运营商的连接可靠性也无法保障。

好在源代码我在 前面的 Github 链接 那里都给了你,所以你可以利用它在本机或者自己的私有服务器上搭建服务。

如果你要尝试自己运行服务,可以参考 我的这份教程 快速了解 Streamlit 的使用方法。

祝使用愉快!

延伸阅读

你可能也会对以下话题感兴趣。点击链接就可以查看。

> 下载少数派 客户端 、关注 少数派公众号 ,了解更妙的数字生活 🍃

> 想申请成为少数派作者?冲!