標準模式
本頁比較 standard: true 與擴充模式各自支援的語法,以及哪個元件使用哪種模式。
哪個元件用哪種模式
| 元件 | 模式 | 能否切換 |
|---|---|---|
MDParser |
預設標準模式(standard: true) |
建構時傳 standard: false 改為擴充模式 |
MDViewer |
一律擴充模式 | 不能 |
MDEditor.download("html") |
一律擴充模式 | 不能 |
標準模式略過的函式
standard 為 true 時,transToHTML() 會跳過下列六個函式,改由對應的標準版處理:
| 略過 | 由誰替代 | 失去的功能 |
|---|---|---|
setPreCode |
無 | fenced code block(```)與 Mermaid 區塊,原文會照樣輸出 |
setMedia |
setMediaDefault |
圖片尺寸與對齊後綴 (寬x高 left) |
setLink |
setLinkStandard |
YouTube、Vimeo 嵌入播放器 |
setFont |
setFontStandard |
==標記==、^上標^、~下標~ |
setBlockquote |
setBlockquoteStandard |
[!NOTE] 等提示框樣式 |
setHashtag |
無 | #tag 連結(MDParser 本來就不傳 hashtag 路徑) |
語法對照
| 語法 | 標準模式 | 擴充模式 |
|---|---|---|
| 標題、粗體、斜體、刪除線、行內 code | 支援 | 支援 |
| 連結、自動網址、Email | 支援 | 支援 |
圖片、.mp4/.mov 影片 |
支援 | 支援 |
| 圖片尺寸與對齊 | 尺寸後綴會被吃掉但不套用 | 支援 |
| 表格、列表、checkbox、水平線、引用 | 支援 | 支援 |
| 縮排程式碼區塊 | 支援 | 支援 |
| fenced code block、Mermaid | 不支援 | 支援 |
| 標記、上下標 | 不支援 | 支援 |
提示框 [!NOTE] |
只輸出原文 [!NOTE] 文字 |
支援 |
| YouTube/Vimeo 嵌入 | 輸出一般連結 | 支援 |
選擇建議
| 情境 | 建議 |
|---|---|
| 需要程式碼區塊或 Mermaid | new MDParser({ standard: false }) |
內容來自其他 Markdown 工具,不希望 ^、~、== 被解讀 |
保留預設 standard: true |
要與 MDViewer 預覽結果一致 |
standard: false |