查看“Marp本地指令”的源代码

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


<br>

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

<pre>
 <!-- paginate: true -->

</pre>
您将在右下角看到幻灯片的页码。


<br>

===配置分页===
每张幻灯片上都有两个事情发生：

*渲染页码
*增加页码


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

{| class="wikitable"
|-
! paginate	
! 页码	
! 增量
|-
| true	
| 显示	
| 是
|-
| false	
| 隐藏	
| 是
|-
| hold	
| 显示	
| 否
|-
| skip	
| 隐藏	
| 否
|}


<br>

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

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

</pre>
或者您可以使用spot指令。
 
 ---
 paginate: true
 _paginate: false # 或使用 `_paginate: skip`
 ---


<br>

===paginate: skip和paginate: hold===
要同时排除分页和隐藏分页，使用skip：

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

</pre>

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


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

</pre>

<br>

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

 ---
 header: '页眉内容'
 footer: '页脚内容'
 ---
 
 # 第1页
 
 ---
 
 ## 第2页


它将呈现为HTML片段：

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

</pre>


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

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


<br>

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

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

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


<br>

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


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

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

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

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

</pre>

<br>

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

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

</pre>

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

*backgroundColor
*backgroundImage
*backgroundPosition（默认为居中）
*backgroundRepeat（默认为不重复）
*backgroundSize（默认为覆盖）
*color
如果您想要将图像或颜色设置为单个页面的背景，还可以使用扩展图像语法。