类公文模板使用说明

模板 ID：gongwen

显示名称：类公文模板

当前版本：1.2.1

适合文档：

通知、报告、请示、函、总结等正式文档；
需要公文标题、自动编号章节、落款、图表编号的文档；
以正文段落、列表、表格、图片为主体的正式材料。

这个模板把 Markdown 转换为类公文 PDF。你负责写标题、正文层级、图表和少量特殊标签；模板负责公文版式、自动编号、图表题名、分页和落款。

MVP Markdown

MVP 是“最小可用输入”。复制下面内容，放进 Presto，选择 gongwen 模板，就能得到一份结构完整的公文 PDF。

markdown

---
title: "关于开展 2026 年度安全生产专 | 项检查工作的通知"
author:
  - "安全生产管理处"
  - "消防安全办公室"
date: "2026-05-05"
signature: true
template: "gongwen"
---

各部门、各单位：

为进一步加强安全生产管理，落实安全生产责任制，根据《安全生产法》和上级主管部门要求，决定在全公司范围内开展 2025 年度安全生产专项检查工作。现将有关事项通知如下。

## 工作目标

全面排查安全生产隐患，建立健全安全管理制度，提高全员安全意识，确保全年安全生产事故"零发生"。

## 检查范围与内容

### 检查范围

本次专项检查覆盖公司所有生产经营场所，包括：

1. 各生产车间及仓储区域
2. 办公场所及公共区域
3. 在建工程项目现场

### 重点检查内容

- 安全生产责任制落实情况
- 消防设施设备完好情况
- 特种设备检验及操作人员持证上岗情况
- 危险化学品储存、使用管理情况
- **应急预案**的制定及演练情况

## 工作安排

<!--
图片图号写法示例：

1. 单张图片单独成段书写。模板会自动生成图号，图片题名取图片文件名（不含扩展名），不要在正文里手写“图 1”。

   ![现场检查流程](assets/现场检查流程.png)

   上例会渲染为“图 1 现场检查流程”。

2. 多张图片如果各自独立编号，也分别单独成段书写，图号会按出现顺序自动递增：

   ![消防设施检查](assets/消防设施检查.png)

   ![仓储区域检查](assets/仓储区域检查.png)

   上例会依次渲染为“图 1 消防设施检查”“图 2 仓储区域检查”。

3. 多张图片需要合并为一组子图时，把它们写在同一个段落里，并使用相同的替代文本作为总图题；每张子图的小题仍取图片文件名：

   ![安全隐患整改前后对比](assets/整改前.png) ![安全隐患整改前后对比](assets/整改后.png)

   上例会渲染为一组图，主图题为“安全隐患整改前后对比”，子图按（a）（b）标注。
-->

### 自查自纠阶段

各部门、各单位对照检查标准，全面开展自查自纠，建立问题清单，制定整改措施。

### 集中检查阶段

由安全生产管理处牵头，组织相关部门成立联合检查组，对各单位进行全面检查。

### 检查时间安排

| 阶段     | 时间              | 负责部门   |
| -------- | ----------------- | ---------- |
| 自查自纠 | 3 月 1 日 -15 日  | 各部门     |
| 集中检查 | 3 月 16 日 -31 日 | 安全管理处 |
| 整改落实 | 4 月 1 日 -15 日  | 责任单位   |

: 检查工作进度安排

### 整改落实阶段

针对检查中发现的问题，责任单位须在规定期限内完成整改，并将整改报告报送安全生产管理处。

## 工作要求

各部门、各单位要高度重视此次专项检查工作，主要负责人要亲自部署、亲自督办。对检查中发现的重大隐患，要立即整改；对不能立即整改的，要制定切实可行的整改方案，明确整改期限和责任人。

特此通知。

PDF 效果：

title 生成居中的公文主标题；
author 和 date 用于文档 metadata、标题区或文末落款；
signature: true 在文末生成右侧落款；
## 自动显示为 一、；
### 自动显示为 （一）；
普通正文自动首行缩进 2 字符；
表格、图片和图题按模板规则自动编号。

结构映射总览

Markdown 输入	PDF 效果
`title`	页面顶部公文主标题
`title` 中的竖线字符	主标题强制换行
`author`	标题下作者，或文末落款作者
`date: "YYYY-MM-DD"`	文末日期，省略时默认当天日期
`signature: true`	文末右侧自动落款
`template: "gongwen"`	Presto 自动选择模板，不显示在 PDF
`##`	一级正文标题，自动编号为 `一、`
`###`	二级正文标题，自动编号为 `（一）`
`####`	三级正文标题，自动编号为 `1.`
二至五级标题后紧挨正文	标题保留自动编号和格式，正文紧跟在标题后
标题中 `部分内容`	只加粗标题里的对应内容
标题末尾 `{.bold}`	整条标题加粗，包括自动序号
普通段落	自动首行缩进 2 字符
段末 `{.noindent}`	当前段落顶格
独立段落 `{.br}` / `{.br:N}`	空 1 行 / 空 N 行
独立段落 `{.pagebreak}`	强制分页
Markdown 表格后 `: 表题`	自动生成 `表N 表题`
表格单元格内 `<br>`	单元格内换行，并按 22 行网格保持行距
fenced code block	代码块，统一使用等宽简体代码字体
`![说明](图片路径)`	插入图片并自动编号

模板二进制发现

Presto 官方模板的 Release 资产按平台命名，例如 presto-template-gongwen-darwin-arm64、 presto-template-gongwen-linux-amd64、presto-template-gongwen-windows-amd64.exe。这些是安装器或注册表按 os/arch 选择的下载资产，不是本地运行时应直接猜测执行的路径。

平台	Release 资产名
macOS Apple Silicon	`presto-template-gongwen-darwin-arm64`
macOS Intel	`presto-template-gongwen-darwin-amd64`
Linux ARM64	`presto-template-gongwen-linux-arm64`
Linux AMD64	`presto-template-gongwen-linux-amd64`
Windows ARM64	`presto-template-gongwen-windows-arm64.exe`
Windows AMD64	`presto-template-gongwen-windows-amd64.exe`

本地安装后，Presto 会把当前平台对应资产安装到应用数据目录，并使用稳定可执行文件名：

平台	默认本地可执行文件
macOS	`$HOME/Library/Application Support/com.mrered.presto/templates/gongwen/presto-template-gongwen`
Linux	`${XDG_DATA_HOME:-$HOME/.local/share}/com.mrered.presto/templates/gongwen/presto-template-gongwen`
Windows	`%LOCALAPPDATA%\com.mrered.presto\templates\gongwen\presto-template-gongwen.exe`
OpenClaw	`/root/.openclaw/workspace/.presto/bin/presto-template-gongwen`

自动化脚本或 AI 技能应先检查 PRESTO_TEMPLATE_GONGWEN，再按当前平台查找上述本地安装路径。如果设置了 PRESTO_DATA_DIR，优先检查 $PRESTO_DATA_DIR/templates/gongwen/presto-template-gongwen（Windows 为 .exe）。找不到可执行模板时，应提示用户安装/更新模板或显式指定路径，不要拼接 Release 资产名继续运行。

Frontmatter 字段

公文标题和后台输出信息都来自 YAML frontmatter。

yaml

---
title: "关于开展安全生产专项检查工作的通知"
author:
  - "安全生产管理处"
date: "2026-05-09"
signature: true
template: "gongwen"
---

字段说明：

字段	用途
`title`	公文主标题；同时用于预览标题和输出文件名
`author`	作者或发文单位
`date`	发文日期或落款日期；可省略，省略时默认当天日期
`signature`	是否自动生成文末落款
`template`	模板 ID；让 Presto 自动选择对应模板，不显示在 PDF

正文结构

正文推荐从称呼段和 ## 标题开始：

markdown

各部门、各单位：

## 工作目标

全面排查安全生产隐患，建立健全安全管理制度。

## 工作安排

1. 各部门开展自查自纠；
2. 安全生产管理处组织集中检查；
3. 对发现的问题限期整改。

写作约定：

不要手写 一、、（一） 等章节编号；
不要在正文里再写一个 # 主标题；
称呼段放在第一个 ## 前；
二至五级标题后紧挨正文、不留空行时，正文会直接跟在带编号标题后；留空行则显示为独立标题；
标题中局部加粗用 **...**；需要把自动序号也一起加粗时，在标题末尾写 {.bold}；
定制化标签统一使用点号形式 {.tag}：顶格 {.noindent}、恢复缩进 {.indent}、空行 {.br:N}、分页 {.pagebreak}；
表格内换行使用 <br>，单元格内换行和上下表格行会按公文正文 22 行网格保持一致的垂直节奏；
代码块继续使用 Markdown fenced code block，模板会统一使用等宽简体代码字体，避免代码块内中文字体混杂；
图片题名主要取图片文件名或替代文本，文件名应清楚。

常见写法

标题紧跟正文

markdown

## 工作要求

各部门要严格落实责任，按时完成整改。

### 实施步骤

各责任部门按时间节点推进。

#### 检查频次

每周至少开展一次检查。

##### 记录要求

检查记录应完整留存。

PDF 效果：二至五级标题都保留自动编号和标题格式，后面的正文紧跟在同一段中。

标题手动加粗

markdown

## 工作**要求**

## 工作要求 {.bold}

### 实施步骤 {.bold}

#### 检查频次 {.bold}

##### 记录要求 {.bold}

PDF 效果：**要求** 只加粗“要求”；{.bold} 会加粗整条标题，包括模板自动生成的序号。

定制化标签

markdown

这是一段顶格文字。 {.noindent} 这是一段恢复普通缩进的文字。 {.indent}

{.br}

{.br:3}

{.pagebreak}

{.pagebreak:weak}

PDF 效果：{.noindent} 让当前段落顶格；{.indent} 强制使用普通首行缩进；{.br} 和 {.br:N} 控制空行；{.pagebreak} 和 {.pagebreak:weak} 控制分页。

兼容旧写法：::: {.noindent}、{v}、{v:N}、{pagebreak}、{pagebreak:weak}、{indent} 仍可识别；新文档优先使用点号形式。

标题强制换行

yaml

title: "关于开展 2026 年度安全生产专 | 项检查工作的通知"

PDF 效果：主标题在竖线处换行，竖线不会显示。

表格标题

markdown

| 阶段     | 时间              | 负责部门   |
| -------- | ----------------- | ---------- |
| 自查自纠 | 3 月 1 日 -15 日  | 各部门     |
| 集中检查 | 3 月 16 日 -31 日 | 安全管理处 |

: 检查工作进度安排

PDF 效果：表格下方自动生成 表1 检查工作进度安排。

表格内换行写 <br>，模板会让单元格内多行内容的行距与上下表格行的显示距离保持一致。

图片

markdown

![现场检查流程](assets/现场检查流程.png)

PDF 效果：插入图片并生成图题。

检查清单

导出前建议确认：

YAML 中写了 template: "gongwen"；
主标题写在 title 字段里；
正文标题只写语义标题，不手写章节编号；
图片路径相对当前 Markdown 文件可访问。

类公文模板使用说明 ​

MVP Markdown ​

结构映射总览 ​

模板二进制发现 ​

Frontmatter 字段 ​

正文结构 ​

常见写法 ​

标题紧跟正文 ​

标题手动加粗 ​

定制化标签 ​

标题强制换行 ​

表格标题 ​

图片 ​

检查清单 ​

类公文模板使用说明

MVP Markdown

结构映射总览

模板二进制发现

Frontmatter 字段

正文结构

常见写法

标题紧跟正文

标题手动加粗

定制化标签

标题强制换行

表格标题

图片

检查清单