整理 Markdown 的標題、連結、程式碼區塊、表格與換行語法,說明 CommonMark 與 Hugo Goldmark 的使用差異。
適用:CommonMark基礎與Hugo Goldmark;不同編輯器的額外語法不保證通用。
常用語法
# 一級標題
## 二級標題
段落以空白行分開。**粗體**與*斜體*,行內程式碼 `count`。
- 第一項
- 第二項
1. 操作一
2. 操作二
[顯示文字](https://example.com "連結標題")

> 引用文字,來源另附連結。
```javascript
console.log('campfire');
```連結不是(網址 , 標題),標題需加引號並以空格隔開。範例外層用四個反引號,內層三個才不會提前結束。語言名稱決定高亮,不影響程式可否執行。
表格與換行
表格是Goldmark/GFM等實作常見擴充,不是所有CommonMark工具預設支援:
| 工具 | 用途 |
| --- | --- |
| Hugo | 靜態網站 |
| Git | 版本控制 |表格單元格內literal管線需轉義,長內容在本站可橫向捲動。一般換行不一定變<br>,段落用空行;不要依賴不同編輯器的自動換行偏好。
目錄與 Hugo 注意事項
[TOC] 不是所有 Markdown 渲染器都會建立目錄;本站使用 front matter 的 toc 設定與 Hugo.TableOfContents 產生文章目錄。
Hugo unsafe=false,不在文章插原始script/iframe來排版。圖片路徑依據static對映與站點base,內部文章用ref;新例子檔案要存在才能發布,不留下不存在的示範圖連結。
冒險者留言
comments powered by Disqus