v2.0.11

程式碼與圖表

最後更新


本頁涵蓋程式碼區塊的圍欄規則,以及 mermaid、math、chartjs 三種會另外渲染的區塊。

圍欄


規則說明
開頭3 個以上的 ` 或 ~,後面可接語言標籤
結尾同一種字元,數量不少於開頭
巢狀外層用較長或不同字元的圍欄,內層的 ``` 不會提早結束
語言標籤轉小寫;常見語言加上 language-xxx class 供上色,並顯示在區塊左上角
縮排依第一行的縮排對齊,整段向左移除同樣寬度
未閉合讀到文件結尾為止,不帶語言標籤

每個程式碼區塊都附複製按鈕,點擊後顯示 copied 一秒,結果可用 OnCopyClick 接收,見 API 參考。

會另外渲染的區塊


語言標籤需完全等於下列值(mermaid-js、latex 等都是一般程式碼區塊):
標籤渲染器內容
mermaidMermaid流程圖、序列圖等 Mermaid 語法
mathKaTeX區塊數學式
chartjsChart.jsJSON,需有字串 type 與物件 data

這三種區塊在 Refresh() 渲染成功前只顯示一般程式碼區塊;語法錯誤、chartjs 設定不完整或依賴未載入時,維持顯示程式碼區塊。

範例


圍欄


反引號與波浪號圍欄、巢狀圍欄、較長的結尾圍欄,以及緊接在清單後的圍欄。
  1. <div id="out" class="nanomd"></div>
  2. <script type="text/markdown" id="md">
  3. ```js
  4. const a = "<b>not converted</b>";
  5. ```
  6. ~~~js
  7. const b = "~~~ is also a code block";
  8. ~~~
  9. ~~~md
  10. Inside ~~~ you can write ``` as is; only ~~~ closes it
  11. ```js
  12. const c = 1;
  13. ```
  14. ~~~
  15. ````md
  16. An outer fence of 4 backticks is not closed early by ```
  17. ```chartjs
  18. { "type": "bar" }
  19. ```
  20. ````
  21. ```
  22. A closing fence can be longer
  23. `````
  24. - List item
  25. ~~~
  26. ~~~ right after a list is not merged into the item
  27. ~~~
  28. </script>
  29. <script>
  30. const out = document.getElementById("out");
  31. out.innerHTML = MDParser.Parse(document.getElementById("md").textContent).html();
  32. MDParser.Init({ enable: { highlight: true } })
  33. .then(() => MDParser.Refresh(out))
  34. .catch((err) => console.error(err.message));
  35. </script>
即時預覽 · @pardnchiu/nanomd@2.0.11

Mermaid


流程圖與序列圖。
  1. <div id="out" class="nanomd"></div>
  2. <script type="text/markdown" id="md">
  3. ```mermaid
  4. flowchart LR
  5. A[Markdown input] --> B{Block?}
  6. B -->|Yes| C[ParseLines]
  7. B -->|No| D[ParseInline]
  8. C --> E["html()"]
  9. D --> E
  10. ```
  11. ```mermaid
  12. sequenceDiagram
  13. User->>Editor: type text
  14. Editor->>Parser: Parse()
  15. Parser-->>Editor: AST
  16. ```
  17. </script>
  18. <script>
  19. const out = document.getElementById("out");
  20. out.innerHTML = MDParser.Parse(document.getElementById("md").textContent).html();
  21. MDParser.Init({ enable: { mermaid: true } })
  22. .then(() => MDParser.Refresh(out))
  23. .catch((err) => console.error(err.message));
  24. </script>
即時預覽 · @pardnchiu/nanomd@2.0.11

區塊數學式


KaTeX 區塊公式。
  1. <div id="out" class="nanomd"></div>
  2. <script type="text/markdown" id="md">
  3. ```math
  4. \int_0^\infty e^{-x^2} \, dx = \frac{\sqrt{\pi}}{2}
  5. ```
  6. </script>
  7. <script>
  8. const out = document.getElementById("out");
  9. out.innerHTML = MDParser.Parse(document.getElementById("md").textContent).html();
  10. MDParser.Init({ enable: { latex: true } })
  11. .then(() => MDParser.Refresh(out))
  12. .catch((err) => console.error(err.message));
  13. </script>
即時預覽 · @pardnchiu/nanomd@2.0.11

Chart.js


以 JSON 設定的長條圖、圓餅圖與泡泡圖。
  1. <div id="out" class="nanomd"></div>
  2. <script type="text/markdown" id="md">
  3. ```chartjs
  4. {
  5. "type": "bar",
  6. "data": {
  7. "labels": ["Red", "Blue", "Yellow", "Green", "Purple", "Orange"],
  8. "datasets": [{ "label": "# test", "data": [12, 19, 3, 5, 2, 3] }]
  9. }
  10. }
  11. ```
  12. ```chartjs
  13. {
  14. "type": "pie",
  15. "data": {
  16. "labels": ["A", "B", "C"],
  17. "datasets": [{ "data": [30, 50, 20] }]
  18. }
  19. }
  20. ```
  21. ```chartjs
  22. {
  23. "type": "bubble",
  24. "data": {
  25. "datasets": [
  26. { "label": "A", "data": [{ "x": 10, "y": 20, "r": 8 }, { "x": 25, "y": 35, "r": 15 }, { "x": 40, "y": 10, "r": 5 }] },
  27. { "label": "B", "data": [{ "x": 15, "y": 30, "r": 10 }, { "x": 30, "y": 15, "r": 12 }, { "x": 45, "y": 40, "r": 6 }] }
  28. ]
  29. }
  30. }
  31. ```
  32. </script>
  33. <script>
  34. const out = document.getElementById("out");
  35. out.innerHTML = MDParser.Parse(document.getElementById("md").textContent).html();
  36. MDParser.Init({ enable: { chartjs: true } })
  37. .then(() => MDParser.Refresh(out))
  38. .catch((err) => console.error(err.message));
  39. </script>
即時預覽 · @pardnchiu/nanomd@2.0.11

語言標籤需完全相同


只有 mermaid、math、chartjs 會另外渲染,以下維持一般程式碼區塊。
  1. <div id="out" class="nanomd"></div>
  2. <script type="text/markdown" id="md">
  3. ```latex
  4. E = mc^2
  5. ```
  6. ```mathjax
  7. E = mc^2
  8. ```
  9. ```mermaid-js
  10. flowchart LR
  11. A --> B
  12. ```
  13. </script>
  14. <script>
  15. const out = document.getElementById("out");
  16. out.innerHTML = MDParser.Parse(document.getElementById("md").textContent).html();
  17. MDParser.Init({ enable: { mermaid: true, latex: true, highlight: true } })
  18. .then(() => MDParser.Refresh(out))
  19. .catch((err) => console.error(err.message));
  20. </script>
即時預覽 · @pardnchiu/nanomd@2.0.11

退回程式碼區塊


Mermaid 語法錯誤、數學式錯誤、圖表缺 data 與未註冊的圖表類型,都退回一般程式碼區塊。
  1. <div id="out" class="nanomd"></div>
  2. <script type="text/markdown" id="md">
  3. ```mermaid
  4. This is not Mermaid syntax
  5. ```
  6. ```math
  7. \frac{1}{
  8. ```
  9. ```chartjs
  10. { "type": "bar" }
  11. ```
  12. ```chartjs
  13. { "type": "unknown", "data": { "datasets": [{ "data": [1, 2, 3] }] } }
  14. ```
  15. </script>
  16. <script>
  17. const out = document.getElementById("out");
  18. out.innerHTML = MDParser.Parse(document.getElementById("md").textContent).html();
  19. MDParser.Init({ enable: { mermaid: true, latex: true, chartjs: true } })
  20. .then(() => MDParser.Refresh(out))
  21. .then(() => { console.log("rendered:", out.querySelectorAll("[data-rendered]").length, "code blocks:", out.querySelectorAll(".nanomd > pre.prettyprint").length); })
  22. .catch((err) => console.error(err.message));
  23. </script>
即時預覽 · @pardnchiu/nanomd@2.0.11
EN