Skip to content

官方模板使用说明

这里是 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 打开文件时会根据它尝试自动选中对应模板;
  • 模板特有字段和正文结构请阅读对应模板页面。

推荐阅读顺序

如果你第一次使用官方模板:

  1. 先打开目标模板页面;
  2. 复制“MVP Markdown”,确认能导出 PDF;
  3. 再阅读“Markdown 到 PDF 映射”;
  4. 最后参考“全功能 Markdown”,按需要加入图表、分页、合并单元格等高级能力。

Presto — Markdown to PDF