軽量マークアップの静的ビルド方法の検討

概要

問題

要求

• ページの引用機能
  • 異なるページファイルを引用できる

選択肢

Antora(AsciiDoc)

pros

cons

MkDocs(Markdown)

参考 MkDocs vs. Antora

pros

cons

• CommonMark等には無い構文が多く実装されているため、GitHub等通常のmarkdown環境では表示が崩れてしまう

MkDocs後継プロダクトのZensicalに移行する

MkDocsは3つに分裂して終わった。あなたはどれかを選ばなければいけない

Zensical(Markdown)

pros

cons

• MKDocsと同じく、通常のmarkdown環境では表示が崩れてしまう