markdownに目次をつける。

markd.md

Gist用markdownにする方法

Created: 18.08.18

• 目標
• 手順
• 目次つけ
• 参考リンク

目標

1. Chromebookでも作成できる。
2. 目次つき。
3. 公開できるものも。
4. GitHub pagesとの連携。写真、movie、twitterのため。

手順

1. 下書きは、原則、Paper。
2. markdownとしてdownload。
3. Textyで調整。特に、「**」=>「###」に。
4. CodeanywhereのNode.jsプロジェクトで目次をつける。 => 別項。
5. Gistに登録。

目次つけ

やり方は、これで大体分かる。

• Markdownに目次(TOC)を表示させる - tsunokawaのはてなダイアリー

使うのは、以下。

• thlorenz/doctoc: 📜 Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.

★インストール。

npm install -g doctoc

★目次を入れたい場所に以下。

<!-- START doctoc -->
<!-- END doctoc -->

★localだと、以下のコマンド、は動かない。エラー。bashには、そんなcommandねえよ、と。後述のように、ただ、globalだと動く。

doctoc README.md --github

とりあえず、動いた方法。localにgit initで入れて、入っているフォルダまで掘って…。うーむ。それにしても、なんで、nodeコマンドを省略しているのだろう？本当に省略？

以下では、もちろん、入れた。

markd$ node ./node_modules/doctoc/doctoc node_1.md --github

DocToccing single file "node_1.md" for github.com.

==================

"node_1.md" will be updated

Everything is OK.

まずは、globalで試す。できた。上の★のところ、３つ（doctoc入れたあとは、２つ）実行すればいい、と判明。

参考リンク

1. Markdownに目次(TOC)を表示させる - tsunokawaのはてなダイアリー
2. GitHub 上の Markdown が TOC(目次) を表示してくれないのでどうしようか → ツール自製したよって話 - Qiita
3. github-markdown-toc.goでMarkdown文書の目次を自動生成 - Steel Dragon 14106
4. メモの書き方 - Markdown応用編 #mimemo - mimemo