GitHub Wikiで目次を挿入する(ATOMの場合)

atom-markdown-toc.gif https://atom.io/packages/markdown-toc GitHub の wiki は Markdown(をベースにした言語)を採用しています。 Markdown のいくつかの方言ではタグを記述することで目次を自動挿入することが出来るみたいですが、GitHub ではその機能は実装されていません。でもテキストが長くなってくると、目次欲しいなあと思うんですよね。自力で作ることももちろん出来ますが、面倒くさいし漏れが出がち。多くの先人も同じこと考えていたみたいで、環境に合わせていろいろなツールがあります。 僕の場合Atomエディタを使っているので、このAtomパッケージを使えば目次を挿入できるらしいってことがわかりました。 markdown-toc これをインストールして、実行すれば動くはずなのですが……僕の環境では次の様な問題が。

  • 日本語見出しへのリンクが正しくない
  • プロジェクト毎に1ページしか目次を作ってくれない
見出しに日本語が含まれていると、次の様な感じになって正しくリンクしてくれません。
- [PHP 7.2 のインストール](#php-72-)
またページ1で目次を作ったあとページ2を編集してそこで目次を追加しようとしても、ページ1に追加されてしまいます。

続きを読む