markdown-toc is a JavaScript API and CLI for generating tables of contents from Markdown files. It uses Remarkable to parse Markdown headings and turn them into linked TOC entries. Developers can run it from the command line, inject a TOC directly into a file, or use it programmatically from Node.js. The tool can also output JSON so applications can render their own TOC templates. It includes options for heading depth, bullet style, filtering, slug generation, indentation, and first-heading behavior. It is especially useful for maintaining README files, documentation pages, and generated docs where headings change over time.

Features

  • Markdown table of contents generation
  • CLI and Node API support
  • In-place README injection
  • JSON TOC output
  • Custom slug generation
  • Heading filtering and depth control

Project Samples

Project Activity

See All Activity >

Categories

Markdown Editors

License

MIT License

Follow markdown-toc

markdown-toc Web Site

Other Useful Business Software
$300 Free Credits for Your Google Cloud Projects Icon
$300 Free Credits for Your Google Cloud Projects

Start building on Google Cloud with $300 in free credits. No commitment, no credit card required until you're ready to scale.

Launch your next project with $300 in free Google Cloud credits—no strings attached. Test, build, and deploy without risk. Use your credits across the entire Google Cloud platform to find what works best for your needs. After your credits are used, continue with always-free tier services. Only pay when you're ready to scale. Sign up in minutes and start exploring.
Start Free Trial
Rate This Project
Login To Rate This Project

User Reviews

Be the first to post a review of markdown-toc!

Additional Project Details

Programming Language

JavaScript

Related Categories

JavaScript Markdown Editors

Registered

2026-07-03