导出笔记本为 Markdown (exportNotebookMd)

接口描述

本接口用于将指定 ID 的整个笔记本导出为一系列 Markdown 文件，并将这些文件及其相关资源（如图片）打包成一个 ZIP 压缩文件。

请求参数

请求体为一个 JSON 对象，包含以下字段：

响应体

成功时，响应体为一个 JSON 对象，包含导出的 ZIP 文件信息：

如果发生错误，响应体的 code 字段将为非 0 值，msg 字段将包含错误信息。

请求示例

{
  "notebook": "20200812223209-gtylnr2"
}
            

响应示例

成功响应：

{
  "code": 0,
  "msg": "",
  "data": {
    "name": "笔记本标题.zip",
    "zip": "/temp/export/笔记本标题-20230509110500.zip"
  }
}
            

失败响应（示例）：

{
  "code": 1,
  "msg": "Notebook not found or export failed.",
  "data": null
}
            

错误码

• 0: 成功
• 其他非零值: 失败，具体错误信息请参考 msg 字段。例如，笔记本 ID 无效或导出过程中发生内部错误。

源码定位

后端实现相关的核心逻辑可以在以下文件中找到：

• 路由定义: siyuan/kernel/api/router.go (搜索 /api/export/exportNotebookMd)
• 主要逻辑: siyuan/kernel/api/export.go (函数 exportNotebookMd)
• 模型层导出逻辑: siyuan/kernel/model/export.go (函数 ExportNotebookMarkdown)