文件 1.11.6

標準模式

本頁比較 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
EN