extracttoc 0.3.2

A CLI package to extract and create a table of contents from markdown files.

extracttoc

Extract the table of contents from a markdown file with an easy to use command line tool.

Usage

usage: extracttoc [-h] [-s] [-l LEVEL_LIMIT] file

Extracts the table of contents from a markdown file.

positional arguments:
  file                  Provide a markdown file from which to extract the toc.

optional arguments:
  -h, --help            show this help message and exit
  -s, --save            Write the table of contents to a md file. File name will be: {input-file-name}-toc.md
  -l LEVEL_LIMIT, --levels LEVEL_LIMIT
                        Set the number of levels which will be included in the TOC.

Examples

> extracttoc myfile.md

> extracttoc -l 2 myfile.md  # limit toc to level 2

> extracttoc -l 2 -s myfile.md  # limit toc to level 2 and write to separate file

Limitations

The cli tool only works with hashtag-formatted headers, but not with equal-sign-formatted headers!

# This header will be recognized and included in the TOC 

Some text paragraph. 



This header will not be recongized. 
=== 

Some text paragraph.