https://github.com/odegnome/tocinator
Will create a Table of Content for your Markdown(.md) files.
https://github.com/odegnome/tocinator
markdown python python3 tableofcontents
Last synced: 2 months ago
JSON representation
Will create a Table of Content for your Markdown(.md) files.
- Host: GitHub
- URL: https://github.com/odegnome/tocinator
- Owner: odegnome
- License: mit
- Created: 2021-05-19T08:34:37.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-07-14T19:01:07.000Z (almost 5 years ago)
- Last Synced: 2026-03-14T21:08:08.379Z (4 months ago)
- Topics: markdown, python, python3, tableofcontents
- Language: Python
- Homepage:
- Size: 103 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TOCinator
[](LICENSE) [](https://pypi.org/project/tocinator/1.0.0/) [](https://GitHub.com/Coder-RG/tocinator/tags/)
This python module parses your Markdown file and generates a Table of Content(TOC)
for that file. It should be noted that this is still in development and may not
always function as expected.
**The TOC below was completely generated using this module.**
## Table of Content
1. [Features of this module](#features-of-this-module)
2. [Code Generated using tocinator](#code-generated-using-tocinator)
3. [Rendered Code](#rendered-code)
4. [Installation](#installation)
5. [How to use this module](#how-to-use-this-module)
1. [What not to do](#what-not-to-do)
6. [General Layout](#general-layout)
## Features of this module
1. Generate Markdown-ready code.
2. Generated TOC has links to the actual headings and subheading. Which means you
can just paste the generated code in your README file and click on any of the links
to go to the desired heading.
## Code Generated using tocinator
Below is an example of TOC generated using tocinator.
The README used in the below snippets is from my [other][1] repository.
Do check it out if you code in C, it might be of your interest.
## Rendered Code
## Installation
**With pip**
```bash
$ pip3 install tocinator
```
**Without pip**
1. Clone this repository.
```bash
$ git clone git@github.com:Coder-RG/tocinator
```
2. Change directory to cloned repository.
```bash
$ cd tocinator
```
3. Run the file at command line:
```bash
$ python3 src/tocinator/tocinator.py
```
## How to use this module
1. Use `##` for headings
2. Use `###` for subheadings.
**Example 1: (installed with pip)**
```bash
$ python3 -m tocinator README.md OUT.md
```
**Example 2: (installed without pip)**
```bash
$ python3 src/tocinator/tocinator.py README.md OUT.md
```
If the .md file is in another folder, then use absolute path.
```bash
$ python3 src/tocinator/tocinator.py /README.md /TEST.md
```
**Example 3: (installed without pip)**
```bash
$ python3 src/tocinator/tocinator.py /home/username/project/README.md /home/username/project/OUT.md
```
### What not to do
1. `#` and `####` are not used in the parsing yet and therefore won't be
displayed in the TOC.
2. Only use alphanumeric for heading and subheadings. Otherwise, the links won't work.
## General Layout
Code is rendered using grip module. Do check out [grip][2] if you want to render your markdown files in your browser.
[1]: https://github.com/Coder-RG/compc
[2]: https://pypi.org/project/grip/