markdown-toc
« Back to VersTracker
Description:
Generate a markdown TOC (table of contents) with Remarkable
Type: Formula  |  Latest Version: 1.2.0@0  |  Tracked Since: Dec 24, 2025
Links: Homepage  |  GitHub  |  Docs  |  formulae.brew.sh
Stars: 1,737  |  Forks: 719  |  Language: JavaScript  |  Category: Developer tools
Tags: markdown documentation cli nodejs toc productivity
Install: brew install markdown-toc
About:
markdown-toc is a Node.js command-line tool and library that programmatically generates a table of contents for Markdown documents. It parses Markdown files using the Remarkable parser to accurately identify headings and their hierarchy. Its main value is automating TOC creation and maintenance for documentation, READMEs, and long-form content.
Key Features:
  • Command-line interface (CLI) for easy integration into workflows
  • Node.js API for programmatic usage in build scripts or applications
  • Customizable TOC generation (depth, bullet style, linking)
  • Ability to update existing TOCs in place within a file
  • Accurate heading parsing via the Remarkable Markdown parser
Use Cases:
  • Automatically generating and updating a TOC for project README files
  • Maintaining navigable documentation for large Markdown-based knowledge bases
  • Integrating TOC generation into static site build pipelines for blogs or docs
Alternatives:
  • doctoc – Similar CLI tool; markdown-toc offers more customization options and uses a different parsing engine.
  • markdown-it-toc-done-right – A plugin for the markdown-it parser, used within a Markdown processing chain rather than as a standalone CLI.
Version History
Detected Version Rev Change Commit
Dec 24, 2025 9:55pm 1.2.0 0 VERSION_BUMP 04e89b56