Notion2Md Markdown 导出工具使用教程

1. 项目介绍

Notion2Md 是一个开源项目，用于将 Notion 页面导出为 Markdown 格式。它基于 Notion 的官方 API 和 Python 编写，可以帮助用户方便地将 Notion 中的内容转换为 Markdown 文件，便于分享和发布到其他平台。

2. 项目快速启动

首先，确保您的系统中已经安装了 Python 环境。

接下来，通过以下命令安装 Notion2Md：

pip install notion2md

安装完成后，您可以使用以下命令来导出 Notion 页面：

notion2md --download -n post -p ~/MyBlog/content/posts -u https://notion.so/

其中 -n 参数指定导出的文件名，-p 参数指定导出文件的保存路径，-u 参数为您的 Notion 页面的 URL。

3. 应用案例和最佳实践

导出单个页面

如果您只想导出 Notion 中的单个页面，可以直接指定页面 URL：

notion2md -u https://notion.so/your-page-url

导出包含子页面的页面

如果 Notion 页面包含子页面，Notion2Md 会自动创建相应的文件夹，并将子页面导出为 Markdown 文件：

notion2md -u https://notion.so/your-page-url --download

使用环境变量存储 Token

出于安全考虑，您可以将 Notion 的 Token 存储在环境变量中：

export NOTION_TOKEN="your_notion_token"

然后在命令中通过 --token 参数使用它：

notion2md --token $NOTION_TOKEN -u https://notion.so/your-page-url

4. 典型生态项目

目前，Notion2Md 是一个独立的工具，但社区中已经有一些项目在扩展其功能，例如：

• Notion2Medium: 一个使用 Notion2Md 将 Notion 页面发布为 Medium 文章的项目。
• 其他自定义脚本: 社区中的一些用户编写了扩展 Notion2Md 功能的脚本，例如增加新的导出选项或支持更多的 Notion 块类型。

通过这些扩展项目，用户可以更灵活地使用 Notion2Md 来满足特定的需求。