Hugoを使うときに便利だと思った設定

HugoでWebサイトをリニューアルする際に、便利だと思った設定などをまとめてみました。

goldmark

goldmarkとは、Hugoで採用されているマークダウンレンダラーです。デフォルトの設定については、Hugo公式サイトを参照してください。

マークダウンファイルにHTMLを直接記述する

hugo.tomlファイルにて、以下のように記述することで、マークダウンファイルで直接HTMLを書くことができるようになります。

[markup.goldmark.renderer]
  unsafe = true

マークダウンファイルで要素にクラスを付与する

hugo.tomlファイルにて、以下のように記述します。

[markup.goldmark.parser.attribute]
  block = true

こうすることで、マークダウンファイルで要素の次の行に{.class名}と記述してクラスを付与することができるようになります。

## これは見出しです
{.important-title}

<h2 class="important-title">これは見出しです</h2>