{"id":25081100,"url":"https://github.com/odegnome/tocinator","last_synced_at":"2026-04-29T14:39:12.048Z","repository":{"id":49134276,"uuid":"368799008","full_name":"odegnome/tocinator","owner":"odegnome","description":"Will create a Table of Content for your Markdown(.md) files.","archived":false,"fork":false,"pushed_at":"2021-07-14T19:01:07.000Z","size":105,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-14T21:08:08.379Z","etag":null,"topics":["markdown","python","python3","tableofcontents"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/odegnome.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-19T08:34:37.000Z","updated_at":"2024-10-30T13:12:39.000Z","dependencies_parsed_at":"2022-09-26T20:30:59.124Z","dependency_job_id":null,"html_url":"https://github.com/odegnome/tocinator","commit_stats":null,"previous_names":["odegnome/tocinator","coder-rg/tocinator"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/odegnome/tocinator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odegnome%2Ftocinator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odegnome%2Ftocinator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odegnome%2Ftocinator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odegnome%2Ftocinator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/odegnome","download_url":"https://codeload.github.com/odegnome/tocinator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odegnome%2Ftocinator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32429690,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","python","python3","tableofcontents"],"created_at":"2025-02-07T04:36:41.094Z","updated_at":"2026-04-29T14:39:12.029Z","avatar_url":"https://github.com/odegnome.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TOCinator\n\n[![MIT license](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Py version](https://img.shields.io/pypi/pyversions/tocinator)](https://pypi.org/project/tocinator/1.0.0/) [![GitHub tag](https://img.shields.io/github/tag/Coder-RG/tocinator.svg)](https://GitHub.com/Coder-RG/tocinator/tags/)\n\nThis python module parses your Markdown file and generates a Table of Content(TOC)\nfor that file. It should be noted that this is still in development and may not\nalways function as expected.\n\n**The TOC below was completely generated using this module.**\n\n## Table of Content\n1. [Features of this module](#features-of-this-module)\n2. [Code Generated using tocinator](#code-generated-using-tocinator)\n3. [Rendered Code](#rendered-code)\n4. [Installation](#installation)\n5. [How to use this module](#how-to-use-this-module)\n   1. [What not to do](#what-not-to-do)\n6. [General Layout](#general-layout)\n\n## Features of this module\n1. Generate Markdown-ready code.\n2. Generated TOC has links to the actual headings and subheading. Which means you\ncan just paste the generated code in your README file and click on any of the links\nto go to the desired heading.\n\n## Code Generated using tocinator\nBelow is an example of TOC generated using tocinator.\nThe README used in the below snippets is from my [other][1] repository.\nDo check it out if you code in C, it might be of your interest.\n![Code](https://raw.githubusercontent.com/Coder-RG/tocinator/master/images/ss1.png)\n\n## Rendered Code\n![Render](https://raw.githubusercontent.com/Coder-RG/tocinator/master/images/ss2.png)\n\n## Installation\n**With pip**\n```bash\n$ pip3 install tocinator\n```\n\n**Without pip**\n\n1. Clone this repository.\n```bash\n$ git clone git@github.com:Coder-RG/tocinator\n```\n2. Change directory to cloned repository.\n```bash\n$ cd tocinator\n```\n3. Run the file at command line:\n```bash\n$ python3 src/tocinator/tocinator.py \u003cinput-file\u003e \u003coutput-file\u003e\n```\n\n## How to use this module\n1. Use `##` for headings\n2. Use `###` for subheadings.\n\n**Example 1: (installed with pip)**\n```bash\n$ python3 -m tocinator README.md OUT.md\n```\n\n**Example 2: (installed without pip)**\n```bash\n$ python3 src/tocinator/tocinator.py README.md OUT.md\n```\n\nIf the .md file is in another folder, then use absolute path.\n```bash\n$ python3 src/tocinator/tocinator.py \u003cpath-to-folder\u003e/README.md \u003cpath-to-folder\u003e/TEST.md\n```\n\n**Example 3: (installed without pip)**\n```bash\n$ python3 src/tocinator/tocinator.py /home/username/project/README.md /home/username/project/OUT.md\n```\n\n### What not to do\n1. `#` and `####` are not used in the parsing yet and therefore won't be\ndisplayed in the TOC.\n2. Only use alphanumeric for heading and subheadings. Otherwise, the links won't work.\n\n## General Layout\n![Code](https://raw.githubusercontent.com/Coder-RG/tocinator/master/images/ss4.png)\n\n![Render](https://raw.githubusercontent.com/Coder-RG/tocinator/master/images/ss3.png)\n\nCode is rendered using grip module. Do check out [grip][2] if you want to render your markdown files in your browser.\n\n[1]: https://github.com/Coder-RG/compc\n[2]: https://pypi.org/project/grip/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodegnome%2Ftocinator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fodegnome%2Ftocinator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodegnome%2Ftocinator/lists"}