Export - Plain

Plain 的交付默认是链接,不是文件 —— 永久链接指向当前版本,收件人可以评论、Fork、问 agent。 /api/export 只在你确实需要一份离线文件时用,导出格式都是 web-native:HTML / PDF / PNG。 Office 格式(.pptx / .docx / .xlsx)只进不出 —— 你可以上传它们变成可编辑的 artifact(见 Brand templates),但 Plain 不导出 Office 文件。真要一份 slide 文件,用 PDF,PowerPoint / Keynote / WPS 都能打开。

Request

POST /api/export
Content-Type: application/json
Authorization: Bearer plain_pk_xxx (或 cookie)

{
  "kind": "deck",
  "format": "pdf",
  "source": "---\nmarp: true\n...",
  "workspace": [],
  "filename": "Q3-pitch"
}

Field	含义
`kind`	”deck” \| “doc” \| “sheet”
`format`	”html” \| “pdf” \| “png”
`source`	源码
`workspace`	@ref / [sheet:embed] 解析上下文
`filename`	不带扩展名,server 会自动加

允许组合

三件套都走同一套 web-native 导出:

deck → html | pdf | png(单页)
doc → html | pdf
sheet → html | pdf | png

Response

html → Content-Type: text/html,自包含 CSS/JS 的完整文档
pdf → Content-Type: application/pdf
png → Content-Type: image/png

都带 Content-Disposition: attachment; filename="..." 让浏览器自动下载。

用例

const res = await fetch('https://inplain.app/api/export', {
  method: 'POST',
  headers: {
    'content-type': 'application/json',
    'authorization': `Bearer ${PAT}`,
  },
  body: JSON.stringify({ kind: 'deck', format: 'pdf', source }),
});
const blob = await res.blob();
const url = URL.createObjectURL(blob);
window.location.href = url;

保真承诺

.pdf → 浏览器打印 pipeline,字体保真;要一份 slide 文件发给别人,PDF 就是答案(PowerPoint / Keynote / WPS 都能开)
.html → 自包含单文件,可离线打开、可 iframe、可托管
.png → 单页/单块位图,贴群、贴文档、贴帖子

多数时候你根本不需要导出。用 /api/render 直接拿 HTML,或者分享永久链接 —— 内容维护一次,Plain 选择合适的表达,交付不是一次下载,而是下一场对话的起点。

如果你需要严格按公司模板视觉输出,先上传模板再生成,见 Brand templates。

​Request

​允许组合

​Response

​用例

​保真承诺

Request

允许组合

Response

用例

保真承诺