Parchment

什么是 Parchment？

Parchment 是一款简单的 SaaS“ Notion 替代品”，围绕创建和组织独立页面与集合构建。它提供简洁的 UI，概念上以将内容组织成页面为中心，集合则作为分组。

Parchment 功能的重要部分是程序化访问：您可以通过 API 管理集合、页面以及页面内的区块。这适用于希望通过代码创建、更新和导出结构化页面内容的用户。

集合和页面（通过 API 操作管理）： 创建、重命名、列出和删除集合与页面，以便以编程方式控制内容结构。
基于区块的页面内容： 页面由有序区块组成（例如标题、文本、列表、代码、分隔线），您可以添加或替换这些区块。
使用 replace_blocks 完全重写页面： replace_blocks 会删除页面上所有现有区块，并按顺序写入新数组——适用于从零生成完整页面。
使用 append_blocks 增量编辑： append_blocks 将区块添加到页面末尾，不会替换现有内容，支持增量工作流。
使用 indent_level 的嵌套列表： bullet_list 和 numbered_list 区块接受 indent_level 整数（0–4）来表示嵌套列表渲染。
基于 HTML 的区块格式化： 区块内容以 HTML 字符串存储；支持的格式包括粗体、斜体、删除线、链接，以及通过标准 HTML 标签的彩色文本。
分组区块（group / delete_group）： 分组区块作为子区块的容器；您先创建分组，然后通过 group_id 将子区块关联，最后可一次性删除分组（及其子区块）。
定义的区块类型： 包括 text、heading1/2/3、bullet_list、numbered_list、todo、quote、divider、code 和 group。

创建 API 密钥 并向 API 基础 URL 发送请求：https://theparchment.app/functions/v1/api。
列出或创建结构： 先使用 list_collections 列出集合，然后使用相应操作创建集合和页面（例如 create_collection、create_page）。
使用区块编写页面内容： 使用 append_blocks 将区块添加到现有页面末尾，或使用 replace_blocks 一次性重写整个页面。
使用 HTML 字符串格式化内容： 为每个区块的 content 提供 HTML 字符串，使用支持的标签（例如，通过 <a href="...">...</a> 添加链接）。
必要时使用分组组织： 先创建 group 区块，然后追加引用该分组的子区块（通过 group_id）；使用 delete_group 删除相关内容。

从结构化数据生成页面： 使用 replace_blocks 从单一真相源写入完整页面布局（标题、分隔线、段落、列表）。
构建“仅追加”文档日志： 使用 append_blocks 在不干扰先前内容的情况下向页面末尾添加新节、更新或条目。
维护层级检查清单： 创建 todo 区块（复选框项），并使用带 indent_level 的嵌套 bullet_list/numbered_list 区块表示子任务或大纲。
跨多页面管理模板化内容区块： 以编程方式创建和重命名页面，然后插入一致的区块序列（包括通过 code 区块类型的代码片段）。
通过分组创建可重用节： 使用分组区块保持相关区块在一起，并使用 delete_group 删除或重新生成整个节。

Parchment API 使用什么端点？

API 基础 URL 为 https://theparchment.app/functions/v1/api。
如何认证请求？

所有请求都需要 x-api-key 标头。文档示例显示 x-api-key: pmt_your_key。
append_blocks 和 replace_blocks 有什么区别？

append_blocks 将新区块添加到页面末尾而不替换现有区块，而 replace_blocks 删除所有现有区块并按数组顺序写入提供的区块。
区块内容是纯文本还是 HTML？

区块内容以 HTML 字符串存储；格式化使用标准 HTML 标签（例如 <strong>、<i>、<a> 和 <span style="color: ...">）。
嵌套列表如何工作？

对于 bullet_list 和 numbered_list，区块支持 indent_level 字段（整数 0–4）来表示嵌套子列表。