查看“Marp全局指令”的源代码


{| class="wikitable"
|-
! 名称	
! 描述
|-
| theme	
| 指定幻灯片集的主题。
|-
| style	
| 指定自定义主题的CSS样式。
|-
| headingDivider	
| 指定标题分隔选项。
|-
| size
| 尺寸。
|-
| math
| 数学库。
|-
| auto-scaling
| 自动缩放。
|}

<br>


==主题==
使用theme全局指令选择一个主题。

<pre>
 <!-- theme: registered-theme-name -->
</pre>

它识别添加到Marpit实例的themeSet中的主题名称。


<pre>
<!-- theme: default -->	
<!-- theme: gaia -->	
<!-- theme: uncover -->
</pre>

<br>

===自定义主题样式===
通常，您可以通过<style>元素调整主题，但在另一个Markdown编辑器中打开时，可能会破坏文档的样式。因此，您可以使用style全局指令来代替<style>。

 ---
 theme: base-theme
 style: |
   section {
     background-color: #ccc;
   }
 ---

<br>

==标题分隔符==
您可以使用headingDivider全局指令，在标题前自动分隔幻灯片页面。此功能类似于Pandoc的--slide-level选项和Deckset 2的“Slide Dividers”选项。

它必须指定标题级别，范围从1到6，或它们的数组。如果数字，则该功能在级别大于或等于指定值的标题中启用；如果是数组，则仅在指定级别启用。


例如，下面的两个Markdown产生相同的输出。

 常规语法
 # 第一页
 
 第一页的内容
 
 ---
 
 ## 第二页
 
 ### 第二页的内容
 
 Hello, world!
 
 ---
 
 # 第三页
 
 😃


<pre>
 标题分隔符

 <!-- headingDivider: 2 -->
 
 # 第一页 
 
 第一页的内容
 
 ## 第二页
 
 ### 第二页的内容
 
 Hello, world!
 
 # 第三页 
 
 😃

</pre>

当您想从普通的Markdown创建幻灯片时，这将非常有用。即使在一般的编辑器中打开使用headingDivider的Markdown，它也能以美观的方式呈现，没有令人不悦的分隔线。

<br>

==尺寸==
您是否想要一个传统的4：3幻灯片尺寸？Marp Core增加了尺寸全局指令的支持。扩展的主题系统可以更轻松地切换幻灯片尺寸。

 ---
 theme: gaia
 size: 4:3
 ---
 
 # A traditional 4:3 slide


Marp的内置主题提供了4K（3840x2160）、16：9（1280x720）、4：3（960x720）的预设尺寸。

 /**
  * @theme foobar
  * @size 4:3 960px 720px
  * @size 16:9 1280px 720px
  * @size 4K 3840px 2160px
  */
 
 section {
   /* A way to define default size is as same as Marpit theme CSS. */
   width: 960px;
   height: 720px;
 }

<br>

==数学库==

支持Pandoc的Markdown样式的数学排版。通过使用$...$将公式包围起来，可以将数学渲染为行内格式，而使用$$...$$则可以将其渲染为块级格式。

<pre>
渲染行内数学公式，如 $ax^2+bc+c$。

$$ I_{xx}=\int\int_Ry^2f(x,y)\cdot{}dydx $$

$$
f(x) = \int_{-\infty}^\infty
    \hat f(\xi)\,e^{2 \pi i \xi x}
    \,d\xi
$$
</pre>


您可以在math全局指令（或JS构造器选项）中选择使用MathJax和KaTeX中的数学库进行排版。默认情况下，我们推荐使用MathJax进行更好的渲染和语法支持，但是如果有大量公式需要渲染，KaTeX的渲染速度更快。

通过math全局指令，Marp Core支持声明在当前Markdown中使用的数学库。


像这样在math全局指令中设置mathjax或katex：

 ---
 # 在此Markdown中声明使用KaTeX
 math: katex
 ---


<br>

==自动缩放==

Marp Core具有一些自动缩放功能：

*标题适应：通过在# &lt;!--fit-->中添加此注释，可以获得更适合幻灯片的大标题。
*代码块和KaTeX块自动缩小：防止块从幻灯片的右侧突出。

如果在使用的主题CSS中定义了@auto-scaling元数据，则可以使用自动缩放功能。

 /*
  * @theme foobar
  * @auto-scaling true
  */
 
 true: 启用所有功能。
 fittingHeader: 启用标题适应功能。
 math: 启用KaTeX数学块的缩放。请注意，MathJax数学块将始终应用自动缩放。
 code: 启用代码块的缩放功能。

Marp Core的所有内置主题都准备好使用全功能的自动缩放。如果您是主题作者，可以使用元数据关键字来控制启用自动缩放的目标元素。

此功能依赖于内联SVG，请注意，如果在构造器选项中设置了inlineSVG: false以禁用Marpit的inlineSVG模式，则此功能将无效。

自动缩放功能设计用于水平缩放。在垂直方向上，如果周围有大量内容，缩放后的元素仍然可能突出幻灯片的顶部和底部。


*标题适应
当标题中包含&lt;!--fit-->注释时，标题的大小将调整以适应幻灯片尺寸。

<pre>
# <!-- fit --> 适应标题
</pre>

此语法类似于Deckset的[fit]关键字，但我们使用HTML注释在渲染为文档的Markdown中隐藏fit关键字。


*自动缩小块
某些块将缩小以适应幻灯片。这对于防止块从幻灯片的右侧突出非常有用。