/

文档类型

.doctype 函数根据不同的使用场景来定义文档类型。每种文档类型都提供了一套专属的功能与行为,针对特定的输出格式进行了定制。

流式(plain

流式文档采用线性布局,没有分页符,内容从上到下一次连续流动。得益于其响应式设计,这种类型非常适合网站与知识管理类文档,风格类似 Notion 或 Obsidian 等工具。

文档由三个主要元素组成:

Plain

页边距内容

页面页边距内容 出现在一个固定位置,在滚动时保持可见。

脚注

脚注 在此文档类型中显示为边注,位于其首次引用旁边的右侧页边距区域。在移动设备上,脚注则出现在页面末尾。

PDF

当你导出为 PDF 时,输出产物包含一个适应全部内容的单页。

分页(paged

分页文档采用传统布局,内容被划分为独立的页面。分页既可以显式 通过手动插入触发,也可以在内容超出可用空间时隐式发生。

Paged

页边距内容

页面页边距内容 出现在每一页的专用区域中。

脚注

脚注 出现在首次引用所在页面的底部,位于一个专用区域。

幻灯片(slides

幻灯片文档专为演示而设计,其布局针对一次显示一张幻灯片进行了优化。除非由布局主题 指定,否则幻灯片会将其内容水平居中。幻灯片切换仅通过显式插入 发生。

Slides

页边距内容

页面页边距内容 出现在每张幻灯片上,没有专用区域,这意味着它可能与实际内容发生重叠。

脚注

脚注 出现在首次引用所在幻灯片的底部,没有专用区域。

PDF

当你导出为 PDF 时:

文档(docs

文档型文档专为技术文档而设计,具有结构化的「导航优先」布局,包含侧边栏、带搜索框的页眉,以及页脚中的导航按钮。这种类型非常适合创建维基、指南和参考资料。你现在正在阅读的这个维基就是一个文档型文档!

文档型文档利用子文档 ,并包含一个轻量、精确且基于客户端搜索的功能,可在整套文档中查找内容。

页边距内容

脚注

脚注 出现在页面底部的专用区域。