MkDocs

MkDocs で生成したサイトをローカルで開くと index.html が開かれない問題

たとえば以下のような Markdown を書いてビルドしたとすると、 - [page1へのリンクです](pages/page1.md) 生成したサイトでは「page1へのリンクです」ハイパーリンクが表示され、これをクリックすると page1.md に相当する HTML ページにアクセスできるはず…

MkDocs でスペース2個のインデントをリストのネストとして認識させたい場合

Markdown を HTML 化する手段として MkDocs は有用な選択肢だ。Sphinx の Markdown 版みたいな使い心地である。 しかし唯一残念なのが (リスト等をネストさせる時の)インデントがスペース4個強制 であること。これがスペース2個だと認識されない。 そこでス…

Markdown を HTML で読む手段として MkDocs と MDwiki を試したので優劣を書く

Markdown は書きやすく、そこそこ読みやすい記法だが、それでも plain text なので不便である。定石は HTML に変換して読むことだと思う。で、その変換手段として色々あるんだけど、今回は MkDocs と MDwiki を比較してみる。 前提 記事のまとめ方 MkDocs と…