Markdown 读取

适用场景

当你需要把页面正文导出为 Markdown 时，使用这个接口。该接口只读取页面内容，不会修改页面本身。

GET /v2/pages/:page_id/content/markdown

接口信息

权限要求

需要同时具备 pages.read 和 blocks.read。

请求参数

响应结果

{
  "object": "markdown",
  "page_id": "22222222-2222-4222-8222-222222222222",
  "markdown": "# 季度规划\n\n- 完成 API 联调\n- 编写发布说明",
  "last_edited_time": "2026-04-09T09:30:00.000Z"
}

行为说明或限制

• 这里返回的是页面正文的 Markdown 表示，不包含页面元数据。
• 如果页面内容包含多级 block，系统会按可读的 Markdown 结构进行导出。
• 读取内容时不会修改页面本身。

错误提示

• 401 unauthorized：token 无效或已过期。
• 403 forbidden：缺少 pages.read、blocks.read，或无权访问该页面。
• 404 not_found：页面不存在。

相关文档

前置阅读

• 获取页面
• 获取块子块

下一步

• 追加块子块

相关参考

• Block 类型
• 通用约定