Skip to content

Insert and maintain a table of contents in Markdown files.

License

Notifications You must be signed in to change notification settings

nochso/tocenize

Repository files navigation

tocenize

MIT license GitHub release Go Report Card Build Status Coverage Status

Insert and maintain a table of contents in Markdown files.

Features

tocenize generates a TOC (table of content) from Markdown files and inserts or updates it in the given file.

  • Cross-platform command line utility
    • Windows, Linux, Mac and *bsd (anything the Go compiler will handle)
  • Anchor links are compatible to GFM (Github flavoured Markdown)
  • Automatic "intelligent" insertion of new TOC
  • Update existing TOCs without moving it
  • Configurable max. and min. header depth
  • Line endings are kept intact (LF or CRLF is detected and then used for new lines)

Installation

Pre-compiled binaries

Compiled binaries are available on the releases page.

Make sure to place it somewhere in your $PATH.

From source

If you have a working Go environment, simply run:

go install github.com/nochso/tocenize/cmd/tocenize

If you've added $GOPATH/bin to your $PATH, you can now run tocenize from anywhere.

Usage

The output of tocenize -h should be self explanatory:

tocenize [options] FILE...

  -d    print full diff to stdout
  -e    update only existing TOC (no insert)
  -indent string
        string used for nesting (default "\t")
  -max int
        maximum depth (default 99)
  -min int
        minimum depth (default 1)
  -p    print full result to stdout
  -v    print version

Alternatives

Changes

All notable changes to this project will be documented in the changelog.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

License

This project is released under the MIT license.