使用指南

排版工匠 Forma — AI Agent 排版引擎，人审核即发布。

什么是排版工匠

排版工匠（Forma）把 Markdown 转成适合微信公众号发布的 HTML。 你只需要用任何编辑器写好 .md 文件，排版工匠负责排版——字号、行距、字色、段间距、标题样式，全部处理完毕。

排版工匠为两类用户设计：内容创作者和 AI Agent。 人用它写文章预览排版，Agent 用它自动生成格式化内容。同一套工具，同一个结果。

支持的 Markdown 语法

排版工匠支持标准 Markdown 和部分扩展语法：

标题

# 一级标题、## 二级标题、### 三级标题。 在「克莱因笔记」主题中，二级标题会自动生成大字编号（44px Klein 蓝）。

内联格式

**加粗** — 加粗文字自动加深为 #0a0a0a，对比正文的 #2a2a2a。
*斜体*、~~删除线~~、`行内代码`。

列表与引用

无序列表（-）、有序列表（1.）、 引用块（>）均支持。

链接与图片

[链接文字](https://...) 和 ![图片描述](images/photo.png)。 图片需放在文章目录的 images/ 子目录下，排版工匠自动发现和渲染。

代码块

围栏代码块（```语言）支持语法高亮。

分隔线

--- 生成分隔线。建议全文只用一条，放在文章结尾和参考来源之间。

四款版式说明

每款版式有独立的视觉体系。在预览页可以实时切换，选最配你内容的那一款。

如何预览和复制到微信

桌面端

打开 预览页，左侧选择版式，右侧 iPhone 模拟框中实时预览排版效果。 满意后点击「复制到微信」按钮，HTML 进入剪贴板，直接粘贴到微信公众号后台编辑器。

手机端

手机打开预览链接，文章全宽渲染——和微信里看到的效果一样。顶部可以搜索切换文章，底部栏可以切换版式。 点击「复制到微信」，在公众号后台粘贴即可。

AI Agent 使用

Agent 通过 API 保存 Markdown 后，排版工匠返回预览链接。 人在浏览器打开链接确认排版，点击复制即可完成发布。

API 参考

Forma 提供 REST API，供开发者或 AI Agent 集成使用。

渲染端点

POST /api/v1/render
Content-Type: application/json

{
  "content": "# 你好世界\n\n这是正文。",
  "theme": "swiss"
}

→ {
  "success": true,
  "data": {
    "html": "<h1>你好世界</h1>...",
    "css": "#forma { ... }",
    "meta": { "wordCount": 12, "readingTimeMinutes": 1 }
  }
}

全部端点

AI Agent 发现入口：llms.txt·llms-full.txt·openapi.json