aimanfatima / indexgen

A simple tool to generate a hyperlinked table of contents or directory tree structure for your Git repositories, outputting as a navigable Markdown file.

Home Page:https://indexgen-36f07323a277.herokuapp.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Hyperlinked Index MD Generator

(or simply - Github Repo Table of Contents Generator)

Description

The Hyperlinked Index MD Generator is a simple tool that creates structured and navigable markdown file that serve as comprehensive indexes (or table of contents) for project directories. It's available both as a web app and a command-line interface (CLI).

Motivation for this project: I maintain a repository where I push all my data structure and algorithm problems, as well as my LeetCode practice exercises. I wanted to use a navigable index as my README because I wished to see all the problems I've solved on the main GitHub project page. A hyperlinked table of contents seemed like a good idea, but I couldn't find any robust solution for it. Hence, I created this project.

Demo

indexgen-demo-gif-compressed

Try It Out

Access the live web application here.

Command Line Interface

For those who prefer working in a terminal environment locally, the CLI version offers powerful and flexible options. Please refer to these guidelines

Contributing

Contributions are welcome! Contributing guidelines is in progress

License

This project is licensed under the GNU GENERAL PUBLIC LICENSE.

About

A simple tool to generate a hyperlinked table of contents or directory tree structure for your Git repositories, outputting as a navigable Markdown file.

https://indexgen-36f07323a277.herokuapp.com/

License:GNU General Public License v3.0


Languages

Language:Python 41.9%Language:HTML 23.6%Language:JavaScript 19.5%Language:CSS 14.9%Language:Procfile 0.1%