上一篇把hugo安裝完後，要來說說在hugo編輯markdown語法的注意事項，還有常用語法。
還沒看的人往這去參閱一下吧:Hugo 學習筆記-1

常用markdown語法

常用的語法可以參考HackMD、3分鐘學會Markdown常用語法、Markdown文件。

注意事項

但在看這些文章前要注意一些事情，hugo與一般Markdown語法有點不同


Picture 1. Markdown Table

由於 Markdown 語法的加入圖片不能調整大小，因此建議使用HTML語法。

如何使用及加入 Shortcodes:

如果只是要使用HTML的語法則可以參考Simple Shortcode to Insert Raw HTML in Hugo這篇的作法。
實作如下:
在網站目錄的\layouts加入shortcodes資料夾
創立一個名為rawhtml.html的檔案，內容如下

<!-- raw html -->
{{.Inner}}

但其實hugo一開始就加入了一些Shortcodes進去，詳情可以參考Shortcodes。
常用的有:


  • ref 和 relref - look up the pages by their relative path

config.toml 設定，可以請用擴充語法

[markup]
  defaultMarkdownHandler = "goldmark"
  [markup.goldmark]
    [markup.goldmark.extensions]
      definitionList = true
      footnote = true
      linkify = true
      strikethrough = true
      table = true
      taskList = true
      typographer = true
    [markup.goldmark.parser]
      attribute = true
      autoHeadingID = true
      autoHeadingIDType = "github"
    [markup.goldmark.renderer]
      hardWraps = true
      unsafe = true
      xhtml = true
    [markup.tableOfContents]
      endLevel = 3
      ordered = false
      startLevel = 2

參考資料:

3分鐘學會Markdown常用語法
Markdown文件
Create Your Own Shortcodes
Simple Shortcode to Insert Raw HTML in Hugo
hugo 文檔
hugo on github