官方模板使用说明
这里是 Presto 官方模板的使用入口。每个模板都有独立页面,分别说明:
- 这个模板适合什么文档;
- Markdown 的每个结构会变成 PDF 中的什么区域;
- 支持哪些 frontmatter 字段和特殊标签;
- 最小可用 Markdown(MVP);
- 全功能 Markdown(覆盖模板的主要能力)。
模板列表
| 模板 ID | 显示名称 | 当前版本 | 独立说明页 | 适合文档 |
|---|---|---|---|---|
gongwen | 类公文模板 | 1.2.1 | 类公文模板 | 通知、报告、请示、总结、会议纪要等正式文档 |
jiaoan-jihua | 授课进度计划表模板 | 1.0.2 | 授课进度计划表模板 | 工学一体化课程、基本技能课程、授课进度计划表 |
jiaoan-shicao | 实操教案模板 | 2.0.2 | 实操教案模板 | 职业教育、实训课、项目化教学活动设计 |
如何选择模板
选择 gongwen:
- 你要写的是通知、报告、请示、函、总结等正式文档;
- 你希望 PDF 有公文标题、自动编号章节、落款、图表编号;
- 你的内容主要是正文段落、列表、表格、图片。
选择 jiaoan-jihua:
- 你要写的是按周次推进的授课进度计划表;
- 你希望模板根据首个授课日和内置校历自动计算学年、学期、周次、星期和学时;
- 你的内容天然分为学习任务、学习环节和教学内容。
选择 jiaoan-shicao:
- 你要写的是实操课教案或教学活动设计;
- 你希望 PDF 自动生成横向 A4 表格;
- 你的内容天然分为学习环节、学习单元、教学活动、课时、学习内容、学生活动、教师活动、教学方法。
通用 frontmatter
官方模板都建议在 Markdown 顶部写 template 字段,方便 Presto 自动选择模板:
yaml
---
template: "gongwen"
---或:
yaml
---
template: "jiaoan-shicao"
---PDF 效果:
template字段不会显示在 PDF 中;- Presto 打开文件时会根据它尝试自动选中对应模板;
- 模板特有字段和正文结构请阅读对应模板页面。
推荐阅读顺序
如果你第一次使用官方模板:
- 先打开目标模板页面;
- 复制“MVP Markdown”,确认能导出 PDF;
- 再阅读“Markdown 到 PDF 映射”;
- 最后参考“全功能 Markdown”,按需要加入图表、分页、合并单元格等高级能力。
