Marp 使用細節

用 Marp 做投影片有些額外的需求,上網讀了官方文件有了如下筆記。

圖片大小及全圖背景

Marp 利用了 markdown 圖片語法中原本用來放 alternative text 的地方來放圖片描述詞。可以用的選項包括:

  • 寬度 width:100px、高度 height:100px
  • 模糊 blur、灰階 grayscale、亮度 brightness

例如:![width:100px](image.png)。另外,在替代文字的開頭設置 bg 則可以讓圖片變成背景圖,例如:![bg](image.png)。繼續添加 right 或 left 則可以變成半幅背景。完整設定參考官方文件

HTML 元素細節調整

可以利用 HTML 註解來影響單獨的頁面,例如:

￰YFWU00000000￱

或者在 YAML header 使用 style 來描述,例如:

---
style: |
  table {
    font-size: 25px;
  }
  section {
    font-family: "Roboto Slab";
  }
  code {
    font-family: 'Roboto Mono';
  }
---

額外的 YAML header 設定

  • 投影片 footer / header:在開頭的 YAML 添加 footer 項,例如:footer: Author information。Header 部分也是比照使用。
  • 不再用 --- 作為分頁標誌,而是使用 header level 作為表示,需在 YAML 設定 headingDivider: 2 就會讓 Marp 自動按標題等級切割。
  • 可以設定 math 來改變 TeX 渲染引擎,選項可以是 MathJax 或 KaTeX。MathJax 支援的符號類型較完整,但是 KaTeX 速度較快。