【Jekyll】<details>中で箇条書きを使えないときの対処法

起こった現象

Githubpagesに立てたJekyllテーマ「minima」において、HTMLの詳細折りたたみ要素である<details>の中でMarkdownの箇条書きが作れなかった。

詳細折り畳み要素の例

<details open>
  <summary>買い物リスト</summary>
  
1. じゃがいも
1. にんじん
1. たまねぎ
</details>

【実行結果※Qiitaでは箇条書きとして表示できます】

買い物リスト

1. じゃがいも
2. にんじん
3. たまねぎ

解決方法

JekyllのパーサーであるKramdownではHTML内のMarkdown記法はパースされない。このときはHTMLタグにmarkdown="1"のオプションを入れるとうまくいく。

詳細折り畳み要素+markdown="1"

<details open markdown="1">
  <summary>買い物リスト</summary>
  
1. じゃがいも
1. にんじん
1. たまねぎ
</details>

買い物リスト

1. じゃがいも
2. にんじん
3. たまねぎ

試したがうまくいかなかったこと

parse_block_html オプション

下の記事ではconfig.ymlもしくは各ページ内でparse_block_htmlのオプションを有効にすると書いてあるが、うまくいかなかった。

CommonMarkGhPages オプション

下の記事ではconfig.yml内でMarkdownのパーサーをCommonMarkGhPagesとして設定すると書いてあるが、うまくいかなかった。

参考