「Marp」用VSCode做簡報?

logo

Marp是利用Markdown語法編寫簡報的功能，可以簡單的作出俐落的簡報(但沒有什麼花俏的轉場，動畫之類的)，不過可以僅用編輯器就生出來，同時可以使用Markdown語法給予簡報內容整齊又美觀的排版。

Mapr本身是一個開源專案，目前最方便的用法是安裝VSCode的擴充功能，便能以雙欄式操作即時呈現簡報結果。

起手式

要將Markdown的.md檔案變身成簡報，只要在文件前端插入Marp的屬性就可以了：

---
marp: true
theme: default
paginate: true
---

marp: true表示指定這個檔案是Marp簡報檔案

theme: default簡報主題預設有三種：default, gaia, uncover，可以另外以CSS自訂

paginate: true表示顯示簡報頁碼，如果第一頁(或任何一頁不要頁碼)，可以在那一頁開頭插入就可以取消當頁面的頁碼顯示

---只要放3條dash line就是換下一頁了超簡單

常用指令

放在文件開頭屬性的指令(整個簡報的通用設定)

marp: true 指定文件為Marp簡報 theme: default 選定佈景主題 paginate: true 開啟頁碼(預設右下角) backgroundcolor: white 背景為白色(若要使用佈景主題的設定，此項可忽略) color: black 文字為黑色(若要使用佈景主題的設定，此項可忽略) header: ___ 頁首(預設左上角，可放圖片) footer: ___ 頁尾(預設左下角，可放圖片)

放在頁面開頭的的指令(用於單頁面調整)

 前綴_表示只作用在當頁面，取消頁碼  變更當頁面背景  變更當頁面文字顏色 把這一串code放在標題的#和標題文字之間，標題就會自動被放大到填滿頁面

頁面中的指令(內容呈現)

![](image.jpg) 插入圖片(可調尺寸，濾鏡) ![bg](image.jpg) 變更當頁面背景(可調尺寸，濾鏡，圖片縮放方式，也可調整靠左/靠右)

還有其他較複雜/延伸的使用方式可參考官方連結不過基本上與Markdown差不多啦！

自訂主題

基本環境設定

若要自訂簡報主題就需要一點CSS技巧，首先要生成一個CSS檔案(路徑與簡報檔案相同)，接著在VSCode工作區的Marp:Theme設定中加入CSS檔案的檔名就完成了。

主題CSS檔案內容

/* @theme theme-name */

section {
  width: 1280px;
  height: 960px;
  font-size: 40px;
  padding: 40px;
}

h1 {
  font-size: 60px;
  color: #09c;
}

h2 {
  font-size: 50px;
}

/* @theme theme-name */在Metadata中設定主題的名字

section標籤後面是簡報全域設定

接著可以依照一般CSS操作分別對h1~h6, ol, ul, ul, p設定細節

設定完成後回到簡報修改主題名稱就能套用新主題了！更多設定一樣可參考官方連結

輸出簡報檔案

Marp擴充功能可以輸出多種檔案：

副檔名	說明
pdf	通用檔案，方便傳遞
html	會同時生成播放功能界面，可直接放上網站使用
pptx	PowerPoint檔案
jpg	只會輸出第一張投影片圖檔
png	只會輸出第一張投影片圖檔

間質幹細胞治療早產兒支氣管發育不全

Markdown Cheatsheet