ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Markdown 筆記:語法、程式碼與 Hugo 差異

任務導覽 TABLE OF CONTENTS

整理 Markdown 的標題、連結、程式碼區塊、表格與換行語法,說明 CommonMark 與 Hugo Goldmark 的使用差異。

適用:CommonMark基礎與Hugo Goldmark;不同編輯器的額外語法不保證通用。

常用語法

# 一級標題
## 二級標題

段落以空白行分開。**粗體**與*斜體*,行內程式碼 `count`。

- 第一項
- 第二項

1. 操作一
2. 操作二

[顯示文字](https://example.com "連結標題")
![描述圖片內容](images/example.png)

> 引用文字,來源另附連結。

```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

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文