Commands - Plain

plain deck   generate | edit                Deck(可编辑的活 Artifact)
plain doc    generate | edit                Doc(可编辑的活 Artifact)
plain sheet  generate | edit                Sheet(可编辑的活 Artifact)
plain export <file> --to=html|pdf|png       导出 web-native 产物
plain mcp                                   stdio MCP server(给 agent 用)
plain login  [--api-key <pat>]              保存 gateway 凭证
plain config                                查看当前配置
plain logout                                清除 api key

同一份结构化的源可以长出多种活的 Artifact,导出走 web-native 的 HTML / PDF / PNG(sheet 另有 CSV)。 Office 文件(.pptx / .docx / .xlsx)只进不出 —— 上传即变成可编辑的 Artifact,详见导入。真要一份 slide 文件,导出 PDF 即可(PowerPoint / Keynote / WPS 都能打开)。

generate

plain deck generate "为投资人讲清楚 Q3 增长的 8 页 deck"

stdout 是 marp markdown 源。> deck.md 重定向。可选 flags:

--mode=brief|feature — brief = 8-12 页(默认),feature = 18-28 页 Monocle 风长文
--theme=plain-mono|plain-bold|plain-editorial|... — 从 37 个模板里选一个(换模板 0 regeneration,切模板不用重新生成)
--output=deck.md — 直接写文件不打 stdout
--json — 输出包含 source + metadata 的 JSON,给脚本用

edit

plain deck edit deck.md "把第 3 页改成 hero-dark + 加一句结语"

读 deck.md 为 current,把指令送给 editor agent,新 source 写回(或 --output=new.md 不覆盖)。

export

导出走 web-native 格式 —— 交付的是链接,不是文件。

plain export deck.md --to=html --output=deck.html
plain export deck.md --to=pdf
plain export deck.md --to=png
plain export sheet.md --to=csv

不指定 --output 自动用 <basename>.<ext>。

Deck / Doc / Sheet 导出统一是 HTML / PDF / PNG(sheet 另有 CSV)。不导出 Office 文件 —— 要一份能给 PowerPoint / Keynote / WPS 打开的 slide,导出 PDF。

import

上传公司现有的 .pptx / .docx / .xlsx,Plain 把它变成可编辑的 Artifact —— 这是把存量内容(比如公司 PPT 模板)迁进来的核心入口。 Office 只进不出:导入之后所有编辑、导出都走 Plain 的 web-native 路径。

mcp

plain mcp

stdio MCP server,详见 MCP server。

CI 范例

.github/workflows/release-deck.yml

on:
  push:
    tags: ['v*']
jobs:
  release-deck:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: pnpm dlx @plain/cli login --api-key ${{ secrets.PLAIN_PAT }}
      - run: |
          plain deck generate "Release ${{ github.ref_name }} 的 6 页对外 deck" \
            --output=release.md
          plain export release.md --to=pdf --output=release.pdf
      - uses: actions/upload-artifact@v4
        with: { path: release.pdf }

​generate

​edit

​export

​import

​mcp

​CI 范例

generate

edit

export

import

mcp

CI 范例