命令行导出Notion文章MD文件

痛点

我用笔记工具，很多时候都需要输出成文章发布。发布的时候，我得用 Markdown。很不幸，在 Notion 上，这个过程，从来就没有痛快过。虽然 Notion 从很早就提供 Markdown 导出，还包括子页面。但是导出来的结果，总是无法令我满意。导出的文件是个压缩包，还要手工解压，我就想找一个命令行工具来提高效率。

解决方案

找到了一个开源的Github 项目，叫做 notion2md。

安装

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

你只需要使用pip安装即可：

pip install notion2md

获得并设置 Notion Token

由于需要集成Notion, 在使用前需要 先获得Notion Token，你可以访问 Notion官方链接 获得。

用以下命令设置环境变量：

• Linux:

export NOTION_TOKEN="{your integration token key}"

• Windows(Powershell):

$env:NOTION_TOKEN = "{your integration token key}"

运行

notion2md运行参数不复杂，具体可以参考：

满足我的需求，需要运行以下命令：

notion2md --unzipped -p {your md file path} -u {your notion page url}

坑1：ssl问题

一开始运行会报错，具体如下：

ERROR [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate in certificate chain (_ssl.c:1000)

研究了一下，主要是客户端的问题，需要安装一些证书相关的包：

• Linux：

pip install pip-system-certs

• Windows：

pip install python-certifi-win32

坑2：共享权限问题

一开始无法访问，发现还需要配置文章的共享权限，需要共享页面到刚才建立的connection，具体见下图：