GitHub PagesでMarkdownの<details>内要素がパースされない

2853 ワード
Markdown Jekyll kramdown github-pages Markdown テキストリンク

全て

問題

GitHub Pagesを作成する際, JekyllによるMarkdownからのHTMLページ生成を行ったが<details>内要素がパースされなかった.

なぜ

JekyllではHTML生成にkramdownが使われているが, 標準でparse_block_htmlがfalseになっているためパースされないのであった.

<details><summary>test</summary>
```ruby
p "hello"
\```
</details>

(注: \はエスケープの為入れています.)

解決

ページ生成時のrootディレクトリに作成した_config.ymlに

_config.yml
markdown: CommonMarkGhPages

を追記して解決.

注意

_config.yml
markdown: kramdown
kramdown:
  parse_block_html: true

と記述すると, 1ページ内に複数<details>が存在した場合, バグる.