mkdocsでちょっとハマったのでメモ。

mkdocs.yml

で、こんなnav要素を書いたとします。

nav:
  - index.md
  - Tips:
    - tips/language.md
    - tips/command.md
    - tips/saveload.md

tipsフォルダを掘って、そこに記事を３っつ配置したつもりです。

自動更新されるローカルブラウザのこのURLでは問題なく見れます

http://127.0.0.1:8000/

ところがbuildした結果のHTMLをブラウザで確認すると
languageってフォルダを掘って、そこのindex.htmlを参照しようとして開けません。

nav要素の書き方を色々変えてみたけどやっぱり駄目で。
buildするときのデフォルトオプションがそうなのだと後で気づきました。

mkdocs build --no-directory-urls

これでいける！
その他のオプションは

mkdocs build -h

で確認できます。