yixiong/MorphDoc
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 7 Wiki Activity

release: 发布 v0.5.1

Browse Source 
新增能力：内置 4 套红头、3 套正式文档和 3 套标书主题，支持主题推荐页边距、页面装饰、页眉页脚和页码；增加结构化公文、项目报告及标书 Front Matter，内置 Fandol 中文字体、两份教程和 14 份主题示例。

桌面工作流：重组更多菜单，增加新建、保存、另存为快捷键和未保存确认；另存为后跟随新路径，主题示例自动切换主题，Desktop 发行包完整携带教程、示例与字体。

问题修复：修正红头标题居中与正式文档字体；围栏代码按正文宽度自动换行，长内容安全断行，至少两行即可在当前页分页，并统一保留 8px 左侧内容留白；Docker Web 镜像正确打包 samples。

兼容与部署：未声明主题推荐设置时继续使用 16mm 默认页边距；Web 隐藏不适用的另存为。正式镜像 yixiong/md-to-pdf:v0.5.1 内容 ID 为 sha256:72f519a69bfd6cb2f6df30c2be938e58ceb6f20e4748a32551874de3d436b276，Compose 健康运行。

验证结果：最终修复前 65 个测试文件、286 项测试通过，最终代码块与主题定向测试 27 项通过；全项目类型检查、生产构建和 git diff --check 通过。容器检出 14 套主题、17 份 Markdown，代码块回归 PDF 为 2 页且无越界。NSIS SHA-256 为 676CCE73D782B0B15AC6BC68F253CFBC4740383583E4DAA98F746EDF9999C5CC，ZIP SHA-256 为 82BF6ADF1200604F145CC86FA3ED193955CF6741EBEE3DF8953483515CFF621F。
This commit is contained in:
SkyJourney
2026-07-29 16:58:17 +08:00
parent 58087d0c7e
commit 83e6559c2c
111 changed files with 8274 additions and 173 deletions
Download Patch File Download Diff File Expand all files Collapse all files
samples/README.md
+41
View File
@@ -0,0 +1,41 @@
# 内置教程与主题示例
`themes/` 中的 Markdown 可直接在应用中打开；应用内置的示例菜单会根据
文件名自动切换到同名主题。
`tutorials/` 包含应用“更多 → 使用教程”菜单中的两份教程：
| 教程 | 默认主题 |
| --- | --- |
| `tutorials/echarts-tutorial.md` | Typora Github |
| `tutorials/formal-document-tutorial.md` | 政企红头·标准文件 |
## 推荐主题
| 示例 | 推荐主题 |
| --- | --- |
| `themes/typora-like.md` | Typora Clean |
| `themes/typora-github.md` | Typora Github |
| `themes/typora-pixyll.md` | Typora Pixyll |
| `themes/typora-whitey.md` | Typora whitey |
| `themes/gov-red-standard.md` | 政企红头·标准文件 |
| `themes/gov-red-letter.md` | 政企红头·标准信函 |
| `themes/enterprise-red-simple.md` | 政企红头·企业简版 |
| `themes/red-briefing.md` | 政企红头·纪要简报 |
| `themes/formal-report.md` | 政企正式·工作报告 |
| `themes/formal-regulation.md` | 政企正式·规章制度 |
| `themes/formal-feasibility.md` | 政企正式·可研报告 |
| `themes/tender-classic.md` | 标书正式·经典黑白 |
| `themes/tender-business-blue.md` | 标书正式·商务蓝 |
| `themes/tender-blind.md` | 标书正式·技术暗标 |
## 导出配置提示
- “政企红头·标准文件”“政企红头·标准信函”“政企正式·工作报告”和“政企正式·规章制度”采用党政机关公文版心对应的推荐页边距：上 37mm、下 35mm、左 28mm、右 26mm。
- 企业简版采用上、下、右 25mm、左 28mm；纪要简报采用四边 25mm。
- 可研报告采用上、下 25mm、左 30mm、右 20mm，给左侧装订和批注意见预留空间。
- 经典黑白与商务蓝标书采用上、下、右 25mm、左 30mm。
- 技术暗标采用上、下、右 25.4mm、左 31.7mm，作为常见暗标版式的起始值。
- 可研报告和标书主题会把结构化封面单独分页。
- 技术暗标主题只负责隐藏结构化封面中的投标人和代表字段，不能检查正文、图片、文件名或 PDF 元数据中是否包含身份信息。
- 可研和标书不存在适用于所有项目的统一页边距；暗标的字体、字号、页边距、页码和装订要求尤其应以具体招标文件为准。正式导出前应关闭不允许出现的页眉、页脚和页码，并进行人工合规复核。
samples/themes/enterprise-red-simple.md
+34
View File
@@ -0,0 +1,34 @@
---
title: 关于发布项目交付管理办法的通知
author: 示例科技集团有限公司
subject: 项目交付管理办法
keywords: [企业发文, 管理制度, 项目交付]
document:
profile: official
issuer: 示例科技集团有限公司
number: 示例科发〔2026〕08号
signatory: 李四
date: 2026年7月29日
copyTo: 各事业部, 各区域公司
printingOffice: 集团综合管理部
---
集团各部门、各所属公司：
《项目交付管理办法》已经集团经营管理会议审议通过，现予发布，自2026年8月1日起施行。
## 一、适用范围
本办法适用于集团及所属公司承担的咨询、软件开发、系统集成和运维服务项目。
## 二、关键控制点
| 阶段 | 必备成果 | 责任人 |
| --- | --- | --- |
| 启动 | 项目章程、实施计划 | 项目经理 |
| 建设 | 周报、风险清单、变更记录 | 项目团队 |
| 验收 | 验收报告、移交清单 | 交付负责人 |
## 三、执行要求
各单位应在项目管理平台维护完整记录。重大风险应在一个工作日内升级报告，未经审批不得擅自变更项目范围、预算和关键里程碑。
samples/themes/formal-feasibility.md
+44
View File
@@ -0,0 +1,44 @@
---
title: 可行性研究报告
author: 示例工程咨询有限公司
subject: 智慧园区建设项目可行性研究
keywords: [可行性研究, 项目建设, 投资估算]
document:
profile: project-report
projectName: 智慧园区一体化平台建设项目
documentType: 可行性研究报告
owner: 示例产业园区管理委员会
preparedBy: 示例工程咨询有限公司
version: 送审稿 V1.0
date: 2026年7月
---
# 第一章 总论
## 一、项目概况
本项目拟建设统一的园区管理、企业服务和运行监测平台，形成“一网统管、一企一档、一体服务”的数字化能力。
## 二、建设依据
项目建设依据园区总体规划、数字化转型行动方案以及相关信息安全和数据管理制度开展。
# 第二章 建设必要性
现有系统分散建设、数据标准不统一，跨部门业务协同成本较高。建设统一平台有利于提升园区管理效率和企业服务水平。
# 第三章 建设方案
| 建设内容 | 主要能力 | 计划周期 |
| --- | --- | --- |
| 数据底座 | 数据目录、治理、共享 | 6个月 |
| 管理平台 | 运行监测、事件协同 | 8个月 |
| 企业服务 | 政策匹配、诉求办理 | 6个月 |
# 第四章 投资估算
项目估算总投资为1800万元，包括软件建设、基础设施、安全服务、实施服务和第三方测评费用。
# 第五章 结论
项目建设目标明确，技术路线可行，投资规模合理，具备实施条件。
samples/themes/formal-regulation.md
+46
View File
@@ -0,0 +1,46 @@
---
title: 信息系统项目管理办法
author: 示例集团有限公司
subject: 信息系统项目管理制度
keywords: [规章制度, 项目管理, 信息系统]
---
# 信息系统项目管理办法
## 第一章 总则
### 第一条
为规范集团信息系统项目全生命周期管理，控制项目风险，提高投资效益，根据国家有关规定和集团管理要求，制定本办法。
### 第二条
本办法适用于集团总部及所属单位新建、改建和升级的信息系统项目。
## 第二章 职责分工
### 第三条
数字化管理部门负责项目统筹、技术审查、过程监督和验收管理；需求单位负责业务需求确认、试运行和应用推广。
### 第四条
项目实行负责人制度。项目负责人对建设范围、质量、进度、投资和安全承担管理责任。
## 第三章 项目实施
### 第五条
项目实施应当依次完成立项、采购、建设、测试、试运行、验收和移交。
| 阶段 | 必备材料 | 审批责任 |
| --- | --- | --- |
| 立项 | 需求说明、投资估算 | 需求单位 |
| 建设 | 实施计划、风险清单 | 项目负责人 |
| 验收 | 测试报告、移交清单 | 数字化管理部门 |
## 第四章 附则
### 第六条
本办法由集团数字化管理部门负责解释，自发布之日起施行。
samples/themes/formal-report.md
+38
View File
@@ -0,0 +1,38 @@
---
title: 2026年上半年重点工作报告
author: 示例集团战略发展部
subject: 半年度重点工作报告
keywords: [工作报告, 经营分析, 重点任务]
---
# 2026年上半年重点工作报告
2026年上半年，集团围绕年度经营目标，持续推进业务结构优化、重点项目建设和管理能力提升，总体经营运行保持稳中有进。
## 一、主要指标完成情况
| 指标 | 年度目标 | 上半年完成 | 完成率 |
| --- | ---: | ---: | ---: |
| 营业收入 | 20亿元 | 11.2亿元 | 56% |
| 新签合同额 | 25亿元 | 14.8亿元 | 59.2% |
| 重点项目节点 | 48项 | 27项 | 56.3% |
## 二、重点工作进展
### （一）业务结构持续优化
数字化服务和专业咨询业务收入占比较上年同期提高8个百分点，区域市场协同机制初步形成。
### （二）重大项目有序推进
列入年度计划的12个重大项目全部开工，其中5个项目提前完成阶段目标。
## 三、存在的主要问题
部分区域项目储备不足，跨部门数据共享仍需加强，专业人才结构与新业务发展要求存在差距。
## 四、下半年工作安排
1. 加快重点项目交付和回款。
2. 完善区域市场协同考核机制。
3. 推进经营数据治理和人才专项培养。
samples/themes/gov-red-letter.md
+39
View File
@@ -0,0 +1,39 @@
---
title: 关于征求数字化建设方案意见的函
author: 示例市数据管理局
subject: 征求数字化建设方案意见
keywords: [公文, 函, 数字化]
document:
profile: official
issuer: 示例市数据管理局
number: 示例数函〔2026〕18号
date: 2026年7月29日
copyTo:
- 市发展改革委
- 市财政局
printingOffice: 示例市数据管理局办公室
---
市直各有关单位：
为统筹推进全市数字基础设施建设，我局组织编制了《示例市数字化建设三年行动方案（征求意见稿）》。现就方案内容征求你单位意见。
## 一、重点征求事项
请重点围绕建设目标、年度任务、项目清单、资金安排和数据安全责任等内容提出意见。涉及跨部门协同事项的，请明确牵头单位、配合单位和完成时限。
## 二、反馈方式
请于2026年8月12日前将加盖单位公章的书面意见及电子版反馈至我局。无意见也请书面反馈。
## 三、联系人
联系人：王某，联系电话：0000-12345678，电子邮箱：example@example.com。
感谢对我市数字化建设工作的支持。
为验证末页双线位置，本示例继续提供一段较长的补充说明。各单位在提出意见时，应同步评估现有系统、数据资源、网络环境和运维队伍情况，避免重复建设。对需要纳入年度财政预算的项目，应说明投资估算、资金来源和预期绩效；对涉及公共数据授权运营的事项，应明确数据分类分级、授权边界、安全审计和退出机制。
同时，请结合本单位职责梳理可共享的数据目录，说明更新频率、质量责任和使用限制。涉及个人信息、商业秘密或者重要数据的，应当提出相应的脱敏、访问控制和风险评估措施。意见应当具体、清晰、可执行，原则上不只提出方向性表述。
我局将对反馈意见逐条研究，形成采纳情况说明，并根据论证结果修改完善行动方案。后续需要进一步协调的事项，将另行组织专题会议。
samples/themes/gov-red-standard.md
+40
View File
@@ -0,0 +1,40 @@
---
title: 关于进一步规范项目管理工作的通知
author: 示例市人民政府办公室
subject: 项目管理工作通知
keywords: [公文, 通知, 项目管理]
document:
profile: official
issuer: 示例市人民政府办公室
number: 示例办发〔2026〕12号
urgency: 加急
signatory: 张三
date: 2026年7月29日
copyTo:
- 市发展改革委
- 市财政局
- 市审计局
printingOffice: 示例市人民政府办公室
---
各区人民政府，市政府各部门、各直属机构：
为进一步加强全市重点项目全过程管理，提升项目谋划、建设和验收质量，经市政府同意，现将有关事项通知如下。
## 一、完善项目分级管理机制
各单位应当按照投资规模、建设周期和社会影响，将项目划分为重点项目、一般项目和储备项目，分别建立动态管理台账。
## 二、规范项目建设过程
（一）严格执行立项、规划、用地、环境评价和招标采购等程序。
（二）建立月度调度机制，及时协调解决项目建设中的堵点问题。
（三）重大事项应当形成书面记录并按照权限履行审批程序。
## 三、强化监督检查
市有关部门将定期开展联合检查。对推进有力、成效明显的单位予以通报；对工作滞后、整改不力的单位按规定进行督办。
请各单位结合实际认真贯彻执行。
samples/themes/red-briefing.md
+32
View File
@@ -0,0 +1,32 @@
---
title: 重点项目建设工作推进情况
author: 示例市重点项目办公室
subject: 重点项目工作简报
keywords: [简报, 项目建设, 工作推进]
document:
profile: briefing
masthead: 工作简报
issue: 2026年第12期
publisher: 示例市重点项目办公室
signatory: 王五
date: 2026年7月29日
contact: "报送：市政府领导；发送：各区人民政府、市直有关单位。编辑：综合协调处，电话：0000-12345678。"
---
本周，全市重点项目总体进展平稳，计划内节点完成率为96%，新开工项目8个，完成投资12.6亿元。
## 一、主要进展
一是产业园基础设施项目完成主体结构封顶。二是城市更新一期项目完成首批居民回迁。三是数字政府基础平台完成试运行评审。
## 二、需要关注的问题
部分项目存在前期手续衔接不畅、材料价格波动和专业人员不足等问题。相关责任单位已制定专项措施，预计两周内完成整改。
> 对跨部门协调事项实行清单管理、销号推进；逾期未完成的，由市重点项目办公室提请专题调度。
## 三、下周工作安排
1. 开展三季度项目集中督导。
2. 组织重大项目融资对接活动。
3. 完成年度项目储备库中期评估。
samples/themes/tender-blind.md
+43
View File
@@ -0,0 +1,43 @@
---
title: 技术文件
subject: 城市运行管理平台技术暗标
keywords: [技术暗标, 技术方案, 项目实施]
document:
profile: tender
copyMark: 技术暗标
projectName: 城市运行管理平台建设项目
projectNumber: JS-2026-009
volume: 技术文件
date: 2026年7月
---
# 第一章 项目理解
项目建设应形成城市运行监测、事件协同、指挥调度和综合评价能力，提升跨部门协同效率。
## 一、需求分析
现状系统存在数据标准不统一、事件闭环不完整和运行指标分散等问题，需要建立统一的技术与数据体系。
## 二、建设原则
1. 统一规划，分步实施。
2. 数据驱动，业务协同。
3. 安全可控，稳定可靠。
4. 标准开放，持续演进。
# 第二章 技术方案
## 一、总体架构
采用基础设施层、数据资源层、能力支撑层、业务应用层和展现层的五层架构。
| 层级 | 建设内容 |
| --- | --- |
| 数据资源层 | 目录、治理、共享、指标 |
| 能力支撑层 | 事件、规则、流程、消息 |
| 业务应用层 | 监测、协同、调度、评价 |
# 第三章 实施方案
项目按照准备、设计、建设、试运行和验收五个阶段推进，建立质量、进度、风险和安全管理机制。
samples/themes/tender-business-blue.md
+44
View File
@@ -0,0 +1,44 @@
---
title: 投标文件
author: 示例数字科技有限公司
subject: 智慧办公平台采购项目投标文件
keywords: [投标文件, 商务方案, 智慧办公]
document:
profile: tender
copyMark: 副本
projectName: 智慧办公一体化平台采购项目
projectNumber: CG-2026-018
volume: 商务与解决方案
bidder: 示例数字科技有限公司
representative: 王五
date: 2026年7月29日
---
# 项目理解
本项目旨在建设统一、安全、易用的智慧办公平台，实现组织、流程、消息、知识和移动办公的一体化。
## 业务目标
- 统一用户和组织身份。
- 贯通核心审批流程。
- 建立企业知识资产体系。
- 提供可量化的运营分析。
# 解决方案
## 功能规划
| 模块 | 主要内容 | 交付方式 |
| --- | --- | --- |
| 统一门户 | 待办、消息、应用导航 | 标准产品 |
| 流程中心 | 表单、流程、规则引擎 | 配置实施 |
| 知识中心 | 文档、搜索、权限 | 标准产品 |
## 项目计划
项目分为调研设计、平台建设、试点运行和全面推广四个阶段，总周期为120日历天。
# 服务体系
提供驻场支持、远程服务、定期巡检和管理员培训，形成持续运营机制。
samples/themes/tender-classic.md
+43
View File
@@ -0,0 +1,43 @@
---
title: 投标文件
author: 示例科技有限公司
subject: 数据中心建设项目投标文件
keywords: [投标文件, 技术方案, 项目实施]
document:
profile: tender
copyMark: 正本
projectName: 数据中心基础设施建设项目
projectNumber: ZB-2026-001
volume: 技术及商务文件
bidder: 示例科技有限公司
representative: 李四
date: 2026年7月29日
---
# 第一章 投标响应
我方已认真研究招标文件及相关补充文件，承诺按照招标要求完成项目建设和服务。
## 一、响应一览
| 项目 | 响应内容 |
| --- | --- |
| 工期 | 合同签订后180日历天 |
| 质量目标 | 一次验收合格 |
| 质保期 | 验收后36个月 |
# 第二章 技术方案
## 一、总体架构
项目采用分层解耦、统一管理的总体架构，覆盖计算、存储、网络、安全和运维管理能力。
## 二、实施计划
1. 项目启动与深化设计。
2. 设备到货和安装调试。
3. 系统联调、试运行与验收。
# 第三章 服务承诺
建立7×24小时服务机制，重大故障15分钟响应、2小时到场。
samples/themes/typora-github.md
+59
View File
@@ -0,0 +1,59 @@
---
title: 内网文档渲染服务接入指南
author: 示例研发团队
subject: Markdown 渲染与 PDF API
keywords: [API, Markdown, Mermaid, 代码]
---
# 内网文档渲染服务接入指南
Typora Github 主题适合技术说明、接口文档和包含大量代码的工程资料。本示例
覆盖代码围栏、表格、引用和 Mermaid。
## 渲染流程
```mermaid
flowchart LR
A["Markdown"] --> B["安全渲染"]
B --> C["统一 HTML"]
C --> D["网页预览"]
C --> E["Chromium PDF"]
```
## 请求示例
```ts
const response = await fetch("/api/render", {
method: "POST",
headers: {
"content-type": "application/json"
},
body: JSON.stringify({
markdown: "# 示例",
language: "zh-CN"
})
});
if (!response.ok) {
throw new Error("渲染失败");
}
```
## 接口约束
| 项目 | 限制 |
| --- | --- |
| 原始 HTML | 默认不执行 |
| 远程资源 | PDF 阶段禁止外部网络 |
| 相对图片 | Desktop 从文档目录安全读取 |
| 图表 | 等待渲染完成后再分页 |
> 精确预览与最终 PDF 使用同一份 Chromium 结果；快速预览用于编辑期间的
> 即时反馈。
## 检查清单
- [x] 返回可搜索文本
- [x] 主题资源使用同源地址
- [x] Mermaid 采用严格安全模式
- [ ] 根据部署规模调整 PDF 并发上限
samples/themes/typora-like.md
+43
View File
@@ -0,0 +1,43 @@
---
title: 产品需求评审纪要
author: 示例产品团队
subject: 编辑与导出工作流评审
keywords: [产品评审, Markdown, PDF]
---
# 产品需求评审纪要
> 本示例用于观察 Typora Clean 主题的标题、引用、表格、任务列表与代码排版。
## 一、评审结论
本轮确认优先完成稳定的 Markdown 编辑、分页预览和 PDF 导出链路。预览与
最终文件应复用同一份渲染结果，避免浏览器和桌面端出现两套排版逻辑。
## 二、功能清单
| 能力 | 当前结论 | 验收方式 |
| --- | --- | --- |
| Markdown 编辑 | 支持 | 输入后实时刷新 |
| 主题切换 | 支持 | 切换后保持文档内容 |
| PDF 导出 | 支持 | 文本可搜索 |
| 本地图片 | 桌面端支持 | 与 Markdown 同目录 |
## 三、待办事项
- [x] 统一连续预览和分页预览
- [x] 支持主题推荐页边距
- [ ] 补充更多结构化文档示例
- [ ] 完成发布前跨平台检查
## 四、配置示例
```json
{
"paper": "A4",
"orientation": "portrait",
"marginMode": "theme"
}
```
评审人：产品、设计、研发与测试代表。
samples/themes/typora-pixyll.md
+38
View File
@@ -0,0 +1,38 @@
---
title: 城市公共空间观察札记
author: 示例研究小组
subject: 街区步行环境观察
keywords: [调研, 观察, 城市空间]
---
# 城市公共空间观察札记
## 清晨：街角与通勤
早高峰开始前，沿街商铺逐渐亮起灯光。步行者会自然选择遮阴连续、路口等待
时间较短的一侧街道。空间是否友好，往往体现在座椅、树荫和过街距离这些
不起眼的细节里。
> 好的公共空间并不要求人们停留，却始终为停留保留可能。
## 午后：共享空间的变化
我们在三个时段记录了广场中的主要活动：
| 时段 | 主要使用者 | 常见活动 |
| --- | --- | --- |
| 08:00—09:00 | 通勤者、学生 | 快速通过、等候 |
| 12:00—14:00 | 周边职员 | 午餐、短暂休息 |
| 17:00—19:00 | 居民、儿童 | 散步、游戏、交流 |
## 傍晚：灯光与安全感
照明亮度并不是唯一指标。连续的临街界面、清晰的步行方向和适当的人群密度，
共同决定了夜间安全感。后续设计应优先修复照明断点，并避免绿化遮挡视线。
## 小结
1. 为主要步行路径提供连续遮阴。
2. 缩短路口等待时间，增加安全岛。
3. 在不阻塞通行的位置增加可移动座椅。
4. 保留适合临时活动的小尺度开放区域。
samples/themes/typora-whitey.md
+36
View File
@@ -0,0 +1,36 @@
---
title: 项目周会备忘
author: 示例项目组
subject: 本周进展与下周安排
keywords: [周会, 备忘, 项目管理]
---
# 项目周会备忘
## 本周完成
- 完成主题清单与分类展示。
- 打通网页预览和桌面 PDF 的统一渲染链路。
- 修复长代码块和媒体元素的分页边界问题。
## 关键数据
| 指标 | 本周结果 |
| --- | ---: |
| 自动化测试 | 全部通过 |
| 阻塞问题 | 0 |
| 待复核项目 | 3 |
## 下周安排
1. 完成正式文档主题的字体复核。
2. 增加主题示例和使用教程。
3. 执行安装包与免安装包验收。
## 风险提示
> 暗标、政府公文和企业模板可能存在项目级差异，最终格式应以对应制度或招标
> 文件为准。
负责人：示例项目经理<br>
记录日期：2026年7月29日
samples/tutorials/echarts-tutorial.md
+470
View File
@@ -0,0 +1,470 @@
---
title: Markdown ECharts 图表教程
author: Markdown PDF 导出器
keywords: [ECharts, Markdown, 图表, 教程]
---
# Markdown ECharts 图表教程
本教程介绍如何在 Markdown 中通过 `echarts` 围栏插入可打印的 ECharts
图表。围栏内容使用 YAML，图表会以 SVG 渲染，并与正文一起进入快速
预览、精确预览和最终 PDF。
> `echarts` 围栏不是普通的 `yaml` 代码块。请保留开头和结尾的三个反引号，
> 并将开头写成 `echarts`。
## 一、最小可用示例
下面的内容可以直接复制到 Markdown 正文中：
````markdown
```echarts
version: 1
caption: 各部门季度完成量
height: 58mm
theme: document
option:
xAxis:
type: category
data: [研发, 产品, 设计, 运营]
yAxis:
type: value
series:
- name: 完成量
type: bar
data: [28, 22, 17, 25]
```
````
实际渲染效果如下：
```echarts
version: 1
caption: 各部门季度完成量
height: 58mm
theme: document
option:
xAxis:
type: category
data: [研发, 产品, 设计, 运营]
yAxis:
type: value
series:
- name: 完成量
type: bar
data: [28, 22, 17, 25]
```
## 二、围栏外层字段
围栏最外层只支持下表中的字段，其他字段必须放入 `option`。
| 字段 | 类型 | 必填 | 功能 | 默认值 | 示例 |
| --- | --- | --- | --- | --- | --- |
| `version` | 整数 | 否 | ECharts 围栏协议版本，目前只能是 `1` | `1` | `version: 1` |
| `height` | 长度字符串 | 否 | 固定图表高度，支持 `mm`、`cm`、`in`、`px` | `80mm` | `height: 65mm` |
| `aspectRatio` | 正数 | 否 | 按内容宽度计算宽高比，最大为 `10` | 无 | `aspectRatio: 1.6` |
| `theme` | 枚举 | 否 | 图表配色，可选 `document`、`light`、`dark` | `document` | `theme: light` |
| `caption` | 字符串 | 否 | 显示在图表下方的图注，最长 500 个字符 | 无 | `caption: 图1 月度趋势` |
| `option` | 对象 | 是 | ECharts 的纯数据配置对象 | 无 | `option: { ... }` |
尺寸规则：
- 未设置 `height` 和 `aspectRatio` 时，高度默认为 `80mm`；
- 同时设置两者时，以显式 `height` 作为固定高度；
- 普通统计图建议使用 `50mm`～`85mm`；
- 关系图或层级图可使用 `80mm`～`120mm`；
- 图表超过单页内容区时，系统会等比例缩小到一页内。
## 三、`option` 常用字段
`option` 使用 ECharts 官方的纯数据结构。下表列出正式文档最常用的字段，
不是 ECharts 全部能力的穷举。
| 字段 | 类型 | 功能 | 示例 |
| --- | --- | --- | --- |
| `title` | 对象 | 图内标题、副标题及位置 | `title: { text: 月度趋势, left: center }` |
| `legend` | 对象 | 系列图例、方向和位置 | `legend: { top: 0 }` |
| `tooltip` | 对象 | 浏览器预览中的提示方式 | `tooltip: { trigger: axis }` |
| `grid` | 对象 | 直角坐标图的绘图区边距 | `grid: { left: 48, right: 24 }` |
| `xAxis` | 对象或数组 | 横轴类型、类目和标签 | `xAxis: { type: category }` |
| `yAxis` | 对象或数组 | 纵轴类型、范围和名称 | `yAxis: { type: value }` |
| `dataset` | 对象或数组 | 多系列共享的表格型数据源 | `dataset: { source: [...] }` |
| `series` | 数组 | 图表系列；每项必须有受支持的 `type` | `series: [{ type: line, data: [...] }]` |
| `radar` | 对象 | 雷达图指标名称和最大值 | `radar: { indicator: [...] }` |
| `visualMap` | 对象 | 热力图等数值到颜色的映射 | `visualMap: { min: 0, max: 100 }` |
建议用 `caption` 表示“图 1、数据来源、统计口径”等打印说明；`title`
适合需要在图形内部显示的标题。两者同时使用时会分别显示。
### 三种标题不要混用
| 位置 | 写法 | 用途 |
| --- | --- | --- |
| 文档章节标题 | Markdown 的 `## 标题` | 组织整篇文档的章节层级 |
| 图表内部标题 | `option.title.text` | 显示在 SVG 图形内部，可带副标题 |
| 图表下方图注 | 围栏外层的 `caption` | 图号、数据来源、统计口径和补充说明 |
`option.title` 常用字段：
| 字段 | 功能 | 示例 |
| --- | --- | --- |
| `text` | 图内主标题 | `text: 上半年项目交付趋势` |
| `subtext` | 主标题下方的副标题 | `subtext: 统计周期：2026年1—6月` |
| `left` | 水平位置，可用像素、百分比、`left`、`center`、`right` | `left: center` |
| `top` | 垂直位置，可用像素、百分比、`top`、`middle`、`bottom` | `top: 4` |
| `textStyle` | 主标题字体样式 | `textStyle: { fontSize: 18 }` |
| `subtextStyle` | 副标题字体样式 | `subtextStyle: { fontSize: 12 }` |
`option.legend` 会从 `series[].name` 或 `dataset` 列名生成图例。多系列
图表应为每个系列设置清晰的 `name`，并给标题、图例和绘图区留出互不
重叠的空间。
## 四、图表标题与顶部图例：折线图
````markdown
```echarts
version: 1
caption: 图1 项目交付统计；数据来源：项目管理系统
height: 76mm
option:
title:
text: 上半年项目交付趋势
subtext: 统计周期：2026年1—6月
left: center
top: 4
textStyle:
fontSize: 18
subtextStyle:
fontSize: 12
tooltip:
trigger: axis
legend:
data: [计划, 实际]
top: 48
grid:
left: 48
right: 24
bottom: 32
top: 82
containLabel: true
xAxis:
type: category
boundaryGap: false
data: [一月, 二月, 三月, 四月, 五月, 六月]
yAxis:
type: value
name: 项目数
series:
- name: 计划
type: line
smooth: true
data: [12, 15, 18, 20, 24, 28]
- name: 实际
type: line
smooth: true
data: [10, 16, 17, 22, 23, 31]
```
````
```echarts
version: 1
caption: 图1 项目交付统计；数据来源：项目管理系统
height: 76mm
option:
title:
text: 上半年项目交付趋势
subtext: 统计周期：2026年1—6月
left: center
top: 4
textStyle:
fontSize: 18
subtextStyle:
fontSize: 12
tooltip:
trigger: axis
legend:
data: [计划, 实际]
top: 48
grid:
left: 48
right: 24
bottom: 32
top: 82
containLabel: true
xAxis:
type: category
boundaryGap: false
data: [一月, 二月, 三月, 四月, 五月, 六月]
yAxis:
type: value
name: 项目数
series:
- name: 计划
type: line
smooth: true
data: [12, 15, 18, 20, 24, 28]
- name: 实际
type: line
smooth: true
data: [10, 16, 17, 22, 23, 31]
```
## 五、底部图例：使用 `dataset` 的柱状图
`dataset.source` 适合把数据集中写成一张表，多个系列再按列读取。
````markdown
```echarts
version: 1
caption: 图2 分区域合同额与回款额（单位：万元）
height: 70mm
option:
title:
text: 分区域合同执行情况
left: center
top: 4
legend:
bottom: 2
tooltip:
trigger: axis
grid:
left: 48
right: 24
top: 48
bottom: 52
containLabel: true
dataset:
source:
- [区域, 合同额, 回款额]
- [东区, 820, 690]
- [南区, 760, 610]
- [西区, 540, 480]
- [北区, 680, 570]
xAxis:
type: category
yAxis:
type: value
series:
- type: bar
- type: bar
```
````
```echarts
version: 1
caption: 图2 分区域合同额与回款额（单位：万元）
height: 70mm
option:
title:
text: 分区域合同执行情况
left: center
top: 4
legend:
bottom: 2
tooltip:
trigger: axis
grid:
left: 48
right: 24
top: 48
bottom: 52
containLabel: true
dataset:
source:
- [区域, 合同额, 回款额]
- [东区, 820, 690]
- [南区, 760, 610]
- [西区, 540, 480]
- [北区, 680, 570]
xAxis:
type: category
yAxis:
type: value
series:
- type: bar
- type: bar
```
## 六、饼图：名称与数值
饼图数据项使用 `{ name, value }` 结构。正式文档中建议控制分类数量，
避免标签过密。
````markdown
```echarts
version: 1
caption: 图3 年度预算构成
height: 68mm
option:
title:
text: 年度预算构成
subtext: 单位：%
left: "62%"
top: 6
textAlign: center
tooltip:
trigger: item
legend:
orient: vertical
left: left
series:
- name: 预算
type: pie
radius: ["35%", "68%"]
center: ["62%", "50%"]
data:
- { name: 软件采购, value: 36 }
- { name: 基础设施, value: 28 }
- { name: 运维服务, value: 22 }
- { name: 培训推广, value: 14 }
```
````
```echarts
version: 1
caption: 图3 年度预算构成
height: 68mm
option:
title:
text: 年度预算构成
subtext: 单位：%
left: "62%"
top: 6
textAlign: center
tooltip:
trigger: item
legend:
orient: vertical
left: left
series:
- name: 预算
type: pie
radius: ["35%", "68%"]
center: ["62%", "50%"]
data:
- { name: 软件采购, value: 36 }
- { name: 基础设施, value: 28 }
- { name: 运维服务, value: 22 }
- { name: 培训推广, value: 14 }
```
## 七、雷达图：指标与最大值
雷达图必须提供非空的 `radar.indicator`。每组 `series.data[].value`
至少要包含与指标数量相同的数值。
````markdown
```echarts
version: 1
caption: 图4 项目综合评价
height: 72mm
option:
legend:
data: [项目甲, 项目乙]
radar:
indicator:
- { name: 进度, max: 100 }
- { name: 质量, max: 100 }
- { name: 成本, max: 100 }
- { name: 风险, max: 100 }
- { name: 满意度, max: 100 }
series:
- type: radar
data:
- name: 项目甲
value: [86, 92, 78, 81, 90]
- name: 项目乙
value: [91, 84, 88, 76, 85]
```
````
## 八、关系图：节点与连线
关系图使用 `data` 或 `nodes` 描述节点，使用 `links` 或 `edges` 描述关系。
连线的 `source`、`target` 必须引用已存在的节点名称或 ID。
````markdown
```echarts
version: 1
caption: 图5 项目协同关系
height: 78mm
option:
series:
- type: graph
layout: force
roam: false
label:
show: true
force:
repulsion: 260
edgeLength: 90
data:
- { id: pm, name: 项目经理, symbolSize: 58 }
- { id: dev, name: 研发组, symbolSize: 48 }
- { id: test, name: 测试组, symbolSize: 48 }
- { id: ops, name: 运维组, symbolSize: 48 }
links:
- { source: pm, target: dev, value: 3 }
- { source: pm, target: test, value: 2 }
- { source: dev, target: ops, value: 1 }
- { source: test, target: ops, value: 2 }
```
````
## 九、系列类型与数据形状
当前支持 17 种系列。下表重点说明每种系列最容易写错的数据结构。
| `series[].type` | 主要数据结构 | 示例或要求 |
| --- | --- | --- |
| `line`、`bar` | 数值数组或 `dataset.source` | `data: [12, 18, 24]` |
| `scatter` | 坐标二元数组 | `data: [[12, 18], [16, 25]]` |
| `pie`、`funnel`、`gauge` | 名称和有限数值 | `{ name: 已完成, value: 72 }` |
| `radar` | 指标值数组 | `{ name: 项目甲, value: [86, 92, 78] }` |
| `heatmap` | x、y、值三元数组 | `data: [[0, 0, 32], [1, 0, 48]]` |
| `boxplot` | 最小值、Q1、中位数、Q3、最大值 | `data: [[5, 12, 18, 24, 36]]` |
| `candlestick` | 开盘、收盘、最低、最高 | `data: [[20, 24, 18, 28]]` |
| `tree` | 递归 `children` 节点 | `data: [{ name: 总部, children: [...] }]` |
| `treemap`、`sunburst` | 带数值的递归叶节点 | `{ name: 产品线A, value: 36 }` |
| `graph` | 节点和关系边 | `data: [...]` 配合 `links: [...]` |
| `sankey`、`chord` | 节点和带权关系边 | 关系边需要有限数值 `value` |
| `pictorialBar` | 与柱状图相同 | 可使用安全的内嵌 `path://` 矢量路径 |
每个系列必须直接提供非空 `series[].data`，或者通过有效的
`dataset.source` 提供数据。部分关系图使用 `nodes` 和 `links`，不采用
普通 `data` 数组。
## 十、安全与错误处理
为了确保离线、可复现和安全渲染，配置只能包含纯数据：
- 不支持 JavaScript 函数、自定义脚本或 HTML formatter；
- 不允许外部图片、跳转链接和远程资源；
- 不支持 `custom` 系列；
- YAML 锚点、别名和自定义标签会被拒绝；
- `option` 中的原型污染属性会被拒绝；
- 单个围栏 YAML 不能超过 512 KiB；
- 配置错误只会显示局部错误占位，不会中断整篇文档。
下面是一个会产生局部错误提示的示例，请勿在正式文档中使用：
````markdown
```echarts
version: 1
option:
series:
- type: pie
data: []
```
````
错误信息会指出类似 `option.series.0.data` 的配置路径，便于定位问题。
## 十一、排版建议
1. `caption` 用于图号、数据来源和统计口径，正文标题用于章节结构。
2. 正式报告优先使用少量稳定颜色，并确保黑白打印仍能区分系列。
3. 横轴类目过多时，优先拆图、旋转标签或改用横向柱状图。
4. 图表、图注会作为一个不可拆分媒体块参与分页。
5. 导出前使用“精确”预览检查最终分页、图例和标签。
samples/tutorials/formal-document-tutorial.md
+376
View File
@@ -0,0 +1,376 @@
---
title: 公文与正式文档主题使用教程
author: Markdown PDF 导出器
keywords: [公文, 红头文件, 正式文档, 标书, 教程]
---
# 公文与正式文档主题使用教程
本教程介绍政企红头、政企正式和标书主题的选择方法，以及如何通过文档
开头的 Front Matter YAML 生成红头、发文字号、签发人、简报刊头、项目
封面、投标封面和文末版记。
## 一、Front Matter 是什么
Front Matter 是 Markdown 文件最前面的 YAML 配置，必须由两行 `---`
包围。结束标记之后才开始写正文。
```yaml
---
title: 关于进一步规范项目管理工作的通知
author: 示例市人民政府办公室
subject: 项目管理工作通知
keywords: [公文, 通知, 项目管理]
document:
profile: official
issuer: 示例市人民政府办公室
number: 示例办发〔2026〕12号
date: 2026年7月29日
---
```
注意：
- YAML 使用空格缩进，不要使用 Tab；
- `document` 下的字段需要比 `document:` 多缩进两个空格；
- 日期建议写成明确的中文字符串，例如 `2026年7月29日`；
- 教程或主题示例从“更多”菜单打开时会自动切换主题；
- 普通 Markdown 文件中的 Front Matter 只描述文档结构，不会自动选择主题。
## 二、选择合适的主题
### 政企红头
- **政企红头·国家标准**：适合通知、决定、请示、报告等较完整的党政机关公文结构。
- **政企红头·信函格式**：适合函、征求意见、答复等信函式公文。
- **政企红头·企业简版**：适合企业内部通知、制度和管理文件。
- **政企红头·工作简报**：适合工作动态、专题简报和阶段性通报。
### 政企正式
- **政企正式·规章制度**：适合制度、办法、细则和管理规范。
- **政企正式·工作报告**：适合总结、汇报、调研和会议材料。
- **政企正式·可研报告**：适合可行性研究、项目建议书和建设方案。
### 标书正式
- **标书正式·经典版**：适合常规投标文件和技术方案。
- **标书正式·商务蓝**：适合企业方案、汇报材料和商务投标。
- **标书正式·暗标版**：适合需要弱化投标人识别信息的技术暗标。
## 三、通用元数据字段
这些字段位于 YAML 最外层，可用于所有主题和 profile。
| 字段 | 类型 | 功能 | 示例 |
| --- | --- | --- | --- |
| `title` | 字符串 | 文档标题；结构化主题会将其用于红头标题或封面标题 | `title: 关于开展专项检查的通知` |
| `author` | 字符串 | 作者或编制单位，同时可写入 PDF 作者元数据 | `author: 示例市人民政府办公室` |
| `subject` | 字符串 | 文档主题，可写入 PDF 主题元数据 | `subject: 专项检查工作通知` |
| `keywords` | 字符串数组 | 文档关键词，可写入 PDF 关键词元数据 | `keywords: [公文, 通知, 检查]` |
| `document` | 对象 | 启用并配置结构化公文、简报、项目报告或标书 | `document: { profile: official }` |
`title` 是结构化主题最重要的通用字段。使用 `official`、`project-report`
或 `tender` 时，正文通常不再重复书写同名一级标题。
字段路径也可以用点号快速定位，例如 `document.profile: official` 表示
YAML 中 `document` 对象下的 `profile: official`，点号路径仅用于说明，
不能直接照此写入 YAML。
## 四、红头公文：`official`
### 最小配置
最小配置适合企业简版红头或暂不需要文号、签发人的文件：
```yaml
---
title: 关于调整项目评审流程的通知
document:
profile: official
issuer: 示例科技集团有限公司
date: 2026年7月29日
---
```
### 完整配置
```yaml
---
title: 关于进一步规范项目管理工作的通知
author: 示例市人民政府办公室
subject: 项目管理工作通知
keywords: [公文, 通知, 项目管理]
document:
profile: official
issuer: 示例市人民政府办公室
number: 示例办发〔2026〕12号
secrecy: 秘密
urgency: 加急
signatory: 张三
date: 2026年7月29日
copyTo:
- 市发展改革委
- 市财政局
- 市审计局
printingOffice: 示例市人民政府办公室
---
```
### `official` 字段表
| 字段 | 类型 | 必填 | 功能 | 示例 |
| --- | --- | --- | --- | --- |
| `profile` | 固定字符串 | 是 | 启用红头公文结构，必须为 `official` | `profile: official` |
| `issuer` | 字符串 | 否 | 红头发文机关名称，并用于文末落款机关 | `issuer: 示例市人民政府办公室` |
| `number` | 字符串 | 否 | 发文字号 | `number: 示例办发〔2026〕12号` |
| `secrecy` | 字符串 | 否 | 密级或保密期限 | `secrecy: 秘密` |
| `urgency` | 字符串 | 否 | 紧急程度 | `urgency: 加急` |
| `signatory` | 字符串 | 否 | 签发人姓名 | `signatory: 张三` |
| `date` | 字符串 | 否 | 成文日期，并用于版记日期 | `date: 2026年7月29日` |
| `copyTo` | 字符串或数组 | 否 | 文末抄送机关，最多 30 项 | `copyTo: [市财政局, 市审计局]` |
| `printingOffice` | 字符串 | 否 | 文末版记中的印发机关 | `printingOffice: 市政府办公室` |
`copyTo` 支持两种写法：
```yaml
document:
profile: official
copyTo: 市发展改革委, 市财政局, 市审计局
```
```yaml
document:
profile: official
copyTo:
- 市发展改革委
- 市财政局
- 市审计局
```
抄送信息不需要手工写在正文末尾，结构化主题会自动生成；印发机关和日期
也会进入标准化版记区域。
## 五、工作简报：`briefing`
工作简报使用独立的刊头、期号、编发单位和报送说明。
```yaml
---
title: 重点项目建设工作推进情况
author: 示例市重点项目办公室
subject: 重点项目工作简报
keywords: [简报, 项目建设, 工作推进]
document:
profile: briefing
masthead: 工作简报
issue: 2026年第12期
publisher: 示例市重点项目办公室
signatory: 王五
date: 2026年7月29日
contact: "报送：市政府领导；发送：各区人民政府、市直有关单位。编辑：综合协调处，电话：0000-12345678。"
---
```
| 字段 | 类型 | 必填 | 功能 | 示例 |
| --- | --- | --- | --- | --- |
| `profile` | 固定字符串 | 是 | 启用简报结构，必须为 `briefing` | `profile: briefing` |
| `masthead` | 字符串 | 否 | 简报顶部刊头名称 | `masthead: 工作简报` |
| `issue` | 字符串 | 否 | 期号 | `issue: 2026年第12期` |
| `publisher` | 字符串 | 否 | 编发单位 | `publisher: 市重点项目办公室` |
| `signatory` | 字符串 | 否 | 签发或审核人员 | `signatory: 王五` |
| `date` | 字符串 | 否 | 编发日期 | `date: 2026年7月29日` |
| `contact` | 字符串 | 否 | 报送、发送、编辑及联系方式说明，最长 500 字符 | `contact: "报送：市政府领导；编辑：综合处。"` |
## 六、可研与项目报告：`project-report`
`project-report` 会生成项目报告封面，适合可行性研究报告、项目建议书和
建设方案。
```yaml
---
title: 可行性研究报告
author: 示例工程咨询有限公司
subject: 智慧园区建设项目可行性研究
keywords: [可行性研究, 项目建设, 投资估算]
document:
profile: project-report
projectName: 智慧园区一体化平台建设项目
documentType: 可行性研究报告
owner: 示例产业园区管理委员会
preparedBy: 示例工程咨询有限公司
version: 送审稿 V1.0
date: 2026年7月
---
```
| 字段 | 类型 | 必填 | 功能 | 示例 |
| --- | --- | --- | --- | --- |
| `profile` | 固定字符串 | 是 | 启用项目报告封面，必须为 `project-report` | `profile: project-report` |
| `projectName` | 字符串 | 否 | 项目完整名称 | `projectName: 智慧园区一体化平台建设项目` |
| `documentType` | 字符串 | 否 | 报告类型 | `documentType: 可行性研究报告` |
| `owner` | 字符串 | 否 | 建设、委托或申报单位 | `owner: 示例产业园区管理委员会` |
| `preparedBy` | 字符串 | 否 | 编制单位 | `preparedBy: 示例工程咨询有限公司` |
| `version` | 字符串 | 否 | 文件版本或送审状态 | `version: 送审稿 V1.0` |
| `date` | 字符串 | 否 | 编制日期 | `date: 2026年7月` |
封面之后直接从第一章开始书写，例如：
```markdown
# 第一章 总论
## 一、项目概况
本项目拟建设统一的园区管理、企业服务和运行监测平台。
```
## 七、投标文件：`tender`
### 常规投标文件
```yaml
---
title: 投标文件
author: 示例科技有限公司
subject: 数据中心建设项目投标文件
keywords: [投标文件, 技术方案, 项目实施]
document:
profile: tender
copyMark: 正本
projectName: 数据中心基础设施建设项目
projectNumber: ZB-2026-001
volume: 技术及商务文件
bidder: 示例科技有限公司
representative: 李四
date: 2026年7月29日
---
```
### 技术暗标
暗标通常省略投标人和代表信息，具体要求应以招标文件为准：
```yaml
---
title: 技术文件
subject: 城市运行管理平台技术暗标
keywords: [技术暗标, 技术方案, 项目实施]
document:
profile: tender
copyMark: 技术暗标
projectName: 城市运行管理平台建设项目
projectNumber: JS-2026-009
volume: 技术文件
date: 2026年7月
---
```
### `tender` 字段表
| 字段 | 类型 | 必填 | 功能 | 示例 |
| --- | --- | --- | --- | --- |
| `profile` | 固定字符串 | 是 | 启用标书封面，必须为 `tender` | `profile: tender` |
| `copyMark` | 字符串 | 否 | 正本、副本或技术暗标标记 | `copyMark: 正本` |
| `projectName` | 字符串 | 否 | 招标或采购项目名称 | `projectName: 数据中心基础设施建设项目` |
| `projectNumber` | 字符串 | 否 | 项目或招标编号 | `projectNumber: ZB-2026-001` |
| `volume` | 字符串 | 否 | 分册名称 | `volume: 技术及商务文件` |
| `bidder` | 字符串 | 否 | 投标人名称 | `bidder: 示例科技有限公司` |
| `representative` | 字符串 | 否 | 法定代表人或授权代表 | `representative: 李四` |
| `date` | 字符串 | 否 | 投标或编制日期 | `date: 2026年7月29日` |
## 八、普通正式文档
规章制度和工作报告不一定需要结构化封面。只使用通用元数据，并在正文中
正常书写一级标题即可：
```yaml
---
title: 信息系统项目管理办法
author: 示例集团有限公司
subject: 信息系统项目管理制度
keywords: [规章制度, 项目管理, 信息系统]
---
# 信息系统项目管理办法
## 第一章 总则
```
这种写法适用于“政企正式·规章制度”和“政企正式·工作报告”。不要添加
不存在的 `document.profile`，否则文档会显示配置错误。
## 九、正文写法
红头公文的 Front Matter 结束后直接书写主送机关和正文，不要再次添加
与 `title` 相同的一级标题，否则会重复显示公文标题。
```markdown
各区人民政府，市政府各部门、各直属机构：
为进一步加强全市重点项目全过程管理，现将有关事项通知如下。
## 一、完善项目分级管理机制
各单位应当按照投资规模、建设周期和社会影响建立动态管理台账。
## 二、规范项目建设过程
（一）严格执行项目建设程序。
（二）建立月度调度机制。
```
## 十、页边距、页眉页脚和页码
这些项目不属于 Front Matter 的 `document` 字段，而由主题推荐值和
“导出设置”控制：
| 配置 | 默认行为 | 自定义方式 |
| --- | --- | --- |
| 页边距 | 主题有推荐值时跟随主题，否则四边 `16mm` | 导出设置 → 页边距 → 自定义 |
| 页眉 | 正式主题可提供推荐内容和字体 | 导出设置 → 页眉 |
| 页脚 | 正式主题可提供推荐内容和字体 | 导出设置 → 页脚 |
| 页码 | 红头主题可推荐 `— 1 —` 等公文式页码 | 导出设置 → 页码 |
| 纸张与方向 | 默认 A4 纵向 | 导出设置 → 纸张 |
- 国家标准红头主题使用公文式页码；
- 双面文档页码可按奇偶页放在外侧；
- 信函格式首页可以不显示页码；
- 切换为“自定义”后，导出设置会覆盖主题推荐值。
不要在 Front Matter 中填写 `margin`、`header`、`footer` 或 `pageNumber`
并期待其生效；当前版本不把这些字段作为文档结构协议解析。
## 十一、字体说明
正式主题内置可再分发的 Fandol 中文字体资源，以减少不同电脑之间的显示
差异：
- 正文以宋体风格为主；
- 一级结构标题使用黑体风格；
- 二级结构标题使用楷体风格；
- 红头机关名称使用项目内置的小标宋近似字体方案；
- 页眉页脚使用正式文档主题规定的对应字体。
内置字体用于稳定排版效果，但不声称等同于需要单独授权的商业字体。对
字体有强制采购或归档要求的单位，应按本单位规定配置经授权字体。
## 十二、常见错误
| 现象 | 原因 | 处理方法 |
| --- | --- | --- |
| YAML 被显示成正文 | 文件开头不是 `---`，或缺少结束的 `---` | 确保 Front Matter 位于文件第一行 |
| 提示未知字段 | `document` 使用严格字段校验 | 对照对应 profile 的字段表删除拼写错误或多余字段 |
| 标题出现两次 | `title` 已生成结构标题，正文又写了同名 `#` 标题 | 删除正文中重复的一级标题 |
| 抄送未显示 | `copyTo` 写在了 `document` 外层 | 将其缩进到 `document:` 下面 |
| 主题没有自动切换 | 普通文件不能通过 Front Matter 选主题 | 手动选择主题，或从“更多 → 主题示例”打开 |
| 页边距字段无效 | 页边距不属于文档 profile | 在导出设置中选择“跟随主题”或“自定义” |
## 十三、导出前检查
1. 确认标题、发文机关、发文字号和日期无误。
2. 检查主送机关、落款和抄送信息是否完整。
3. 暗标文件必须再次对照招标要求检查身份信息和版式限制。
4. 使用“精确”预览核对页码、页边距和分页边界。
5. 检查表格、图片、图表和附件说明是否跨页异常。
6. 最终 PDF 应保持文字可搜索，并在归档前完成内容复核。