node-gfmtoc icon indicating copy to clipboard operation
node-gfmtoc copied to clipboard

The GitHub flavored Markdown ToC generator.

gfmtoc

Generate ToC for Markdown text in GitHub Style

  • INSTALL
  • USAGE
  • NOTE
  • LICENSE

INSTALL

$ npm install -g @hail2u/gfmtoc

USAGE

Write foo.md:

Test
====

<!-- #toc -->
<!-- /toc -->

Foo
---

### Foo Foo

### Foo Bar

Bar
---

### Bar Foo

Then run:

$ gfmtoc foo.md

Get:

Test
====

<!-- #toc -->

* [Foo](#foo)
  * [Foo Foo](#foo-foo)
  * [Foo Bar](#foo-bar)
* [Bar](#bar)
  * [Bar Foo](#bar-foo)

<!-- /toc -->

Foo
---

### Foo Foo

### Foo Bar

Bar
---

### Bar Foo

NOTE

marked v0.3.5 has a bug when parsing a comment along with ---- syntax (it’s generate hr) on Node.js v7.4.0. You should avoid using ---- syntax just after comment, especially in gfmtoc’s special comment, by adding blank line(s):

<!-- #toc -->
<!-- /toc -->

----

Or, use **** for hr.

LICENSE

MIT: http://hail2u.mit-license.org/2014