notion-exporter：一键导出Markdown与CSV，释放Notion潜力

notion-exporter：一键导出Markdown与CSV，释放Notion潜力

notion-exporter CLI and library for exporting .md and .csv files from any Notion.so page. 项目地址: https://gitcode.com/gh_mirrors/not/notion-exporter

项目介绍

notion-exporter 是一个简单易用的命令行工具（CLI）和TypeScript库，它允许用户从任何Notion.so页面导出Markdown和CSV文件。利用Notion网页应用的导出功能，用户可以获得与直接在Notion中点击导出相同格式的Markdown和CSV文件，而无需子页面。

项目技术分析

notion-exporter 的核心在于利用了Notion的内部API，通过模拟浏览器行为，使用必要的Cookies进行身份验证，从而实现导出功能。项目采用了TypeScript编写，保证了代码的可维护性和扩展性。其工作原理是通过下载Notion页面的ZIP文件，然后解析并提取出Markdown或CSV文件。

技术架构

• TypeScript：确保类型安全，提高代码质量。
• AdmZip：用于解压ZIP文件，提取Markdown和CSV文档。
• CLI：命令行界面，方便用户在脚本、构建步骤或内容管道中使用。
• 库模式：提供API，允许更复杂的操作，如直接在React/Next.js/Vue等页面中使用。

项目及应用场景

notion-exporter 的出现，为那些希望将Notion作为内容管理系统（CMS）的用户提供了巨大便利。以下是一些具体的应用场景：

1. 静态网站生成：使用Notion编写博客，通过GitHub Action自动导出Markdown文件，并构建静态网站。
2. 数据导出：将Notion中的表格数据导出为CSV文件，便于进一步分析和处理。
3. 自动化工作流：集成到自动化工作流中，实现自动化内容管理和发布。

项目特点

易用性

notion-exporter 的命令行工具非常简单，只需一行命令即可完成Markdown或CSV的导出。对于TypeScript开发者，库模式的API提供了更多灵活性。

稳定性

虽然notion-exporter 依赖于Notion的内部API，但它的导出功能相当稳定。不过，需要注意的是，由于它使用的是内部API，因此存在随时失效的风险。

扩展性

通过提供的库模式，开发者可以轻松地将Markdown内容注入到各种前端框架中，或是对导出的CSV进行直接操作。

兼容性

notion-exporter 支持多种使用方式，无论是通过命令行还是TypeScript库，都提供了详细的文档和帮助信息。

使用说明

获取Cookies

为了使用notion-exporter，用户需要从Notion的浏览器会话中获取两个Cookies：token_v2 和 file_token。这些信息可以从浏览器的开发者工具中找到。

获取页面Block ID

每个Notion页面的URL中都包含了一个唯一的Block ID，这是导出页面的关键。通常，Block ID是URL的最后一部分。

命令行使用

安装全局命令行工具后，通过简单的命令即可导出内容。例如：

notion-exporter 3af0a1e347dd40c5ba0a2c91e234b2a5 -t csv > list.csv

库模式使用

在TypeScript项目中，可以通过以下方式使用notion-exporter：

import NotionExporter from "notion-exporter"

const tokenV2 = ...
const fileToken = ...
const blockId = "3af0a1e347dd40c5ba0a2c91e234b2a5"

await new NotionExporter(tokenV2, fileToken).getMdString(blockId)

通过上述介绍，可以看出notion-exporter 是一个功能强大且易于使用的工具，无论是对个人开发者还是企业用户，都能提供极大的便利。如果你正在寻找一种高效的方法来管理和导出Notion中的内容，那么notion-exporter 绝对值得一试。

notion-exporter CLI and library for exporting .md and .csv files from any Notion.so page. 项目地址: https://gitcode.com/gh_mirrors/not/notion-exporter