Marp本地指令

• paginate：如果设置为true，则在幻灯片上显示页码。
• header：指定幻灯片头部的内容。
• footer：指定幻灯片页脚的内容。
• class：指定幻灯片的<section>元素的HTML类。
• backgroundColor：设置幻灯片的背景颜色样式。
• backgroundImage：设置幻灯片的背景图片样式。
• backgroundPosition：设置幻灯片的背景位置样式。
• backgroundRepeat：设置幻灯片的背景重复样式。
• backgroundSize：设置幻灯片的背景大小样式。
• color：设置幻灯片的颜色样式。

分页

我们通过paginate本地指令支持分页。

 <!-- paginate: true -->

您将在右下角看到幻灯片的页码。

配置分页

每张幻灯片上都有两个事情发生：

• 渲染页码
• 增加页码

您可以通过paginate指令控制这两个事情：

paginate	页码	增量
true	显示	是
false	隐藏	是
hold	显示	否
skip	隐藏	否

在标题幻灯片上跳过分页

一个常见的用例是在分页中排除标题幻灯片。为此，您只需将paginate指令在第二页上定义，而不是第一页。

 # 标题幻灯片
 
 由于缺少`paginate`指令，此页将不显示分页。
 
 ---
 
 <!-- paginate: true -->
 
 分页将从此幻灯片开始呈现（从第2页开始）。

或者您可以使用spot指令。

---
paginate: true
_paginate: false # 或使用 `_paginate: skip`
---

paginate: skip和paginate: hold

要同时排除分页和隐藏分页，使用skip：

 <!-- _paginate: skip -->
 
 # 排除幻灯片
  
 此页不会更新页码，也不会显示分页 

您可以将页面从分页中排除，但保持分页可见，使用hold：

 ---
 paginate: true
 ---
 
 # 幻灯片1
 
 > 第1页，共1页
 
 ---
 
 <!-- _paginate: hold -->
 
 # 幻灯片2
 
 > 第1页，共1页

页眉和页脚

当您需要在多个幻灯片上显示相同的内容，比如幻灯片标题时，可以使用页眉或页脚本地指令。

---
header: '页眉内容'
footer: '页脚内容'
---

# 第1页

---

## 第2页

它将呈现为HTML片段：

 <section>
   <header>页眉内容</header> 
   <h1>第1页</h1>
   <footer>页脚内容</footer>
 </section>
 <section>
   <header>页眉内容</header>
   <h2>第2页</h2>
   <footer>页脚内容</footer>
 </section>

这些内容将被包裹在相应的元素中，并插入到每个幻灯片的正确位置。这些可以看作是幻灯片内容的一部分。

如果您想要将这些内容放置在幻灯片的边缘，就像PowerPoint一样，您需要使用支持的主题。

格式化

此外，您可以使用markdown语法格式化页眉/页脚的内容，并插入内联图片。

---
header: '**加粗** _斜体_'
footer: '![图片](https://example.com/image.jpg)'
---

注意：用（双）引号包裹起来，以避免解析为无效的YAML。页眉和页脚指令不能使用![bg]()语法，因为Markdown的解析顺序。

样式化幻灯片

类别

在某些页面上，您可能希望更改布局、主题颜色等。class本地指令可以更改幻灯片页面的<section>元素的类属性。

假设您正在使用一个包含以下规则的主题：

section.lead h1 {
  text-align: center;
}

您可以通过将类别spot指令设置为lead来使用居中的主标题。

 <!-- _class: lead -->
 
 # THE LEADING HEADER

背景

如果您想要使用任何颜色或渐变作为背景，可以通过backgroundColor或backgroundImage本地指令设置样式。

 <!-- backgroundImage: "linear-gradient(to bottom, #67b8e3, #0288d1)" -->
 
 渐变背景
 
 ---
 
 <!--
 _backgroundColor: black
 _color: white
 -->
 
 黑色背景 + 白色文本

此外，我们还支持自定义这些声明：

• backgroundColor
• backgroundImage
• backgroundPosition（默认为居中）
• backgroundRepeat（默认为不重复）
• backgroundSize（默认为覆盖）
• color

如果您想要将图像或颜色设置为单个页面的背景，还可以使用扩展图像语法。