macOS
Homebrewverified · 100%
brew install markdown-toclocal Homebrew formula metadata
brew
Install markdown-toc with Homebrew, Nix
Generate a markdown TOC (table of contents) with Remarkable. Version 1.2.0 via Homebrew; verified from local package data.
install
Additional install commands
Linux
Nixverified · 92%
nix profile install nixpkgs#markdown-tocnixpkgs package indexes · pkgs/by-name/ma/markdown-toc/package.nix · source: api.github.com
overview
Package summary
Generate a markdown TOC (table of contents) with Remarkable
Project links
Commands and aliases
- markdown-toc
history
Project history and usage
markdown-toc is a Node.js API and CLI for generating and inserting tables of contents in Markdown files.
Project history
The GitHub repository was created in 2013. The README describes markdown-toc as a tool that uses Remarkable to parse Markdown and can be used from the command line or as an API/plugin.
The project belongs to the ecosystem of README automation tools around Jon Schlinkert's packages, Verb, and Assemble-style documentation workflows. Its own README is generated with Verb using markdown-toc, making the package self-demonstrating.
Adoption history
The official repository description says the package is used by many well-known projects and thousands of other projects. The README displays npm version/download badges and documents npm installation, while supplied package facts show Homebrew and Nix packaging as well.
How it is used
The common CLI workflow is to install markdown-toc globally, add a hidden <!-- toc --> marker to a README, and run markdown-toc -i README.md to inject or update the generated TOC. Without in-place mode, the CLI can print a TOC to standard output or JSON.
As an API, markdown-toc returns rendered content plus token data so build scripts can render a custom table of contents. Options cover heading depth, bullet style, slugification, filtering, indentation, and whether to include the first H1.
Why package nerds care
markdown-toc is a classic small Unixy documentation helper: it reads Markdown, emits Markdown, and is easy to wire into README generation. Package maintainers care because it has a stable CLI surface and also doubles as a library for build-time documentation automation.
Timeline
- 2013: GitHub repository created.
- 2010s: README documents npm installation and CLI/API usage for README table-of-contents generation.
- 2026: Supplied package facts list Homebrew and Nix packaging.
Related projects
- The README identifies Remarkable as the Markdown parser used by markdown-toc.
- The README notes it was generated with Verb and can be used as a Remarkable plugin.
Sources
- https://api.github.com/repos/jonschlinkert/markdown-toc
- https://github.com/jonschlinkert/markdown-toc
- source_facts.package-manager
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 1 platform targets.
- Installs with 1 runtime dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
markdown-toc | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version1.2.0
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/jonschlinkert/markdown-toc
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/jonschlinkert/markdown-tocnone confidence
install metadata
Package metadata
| Package key | brew:markdown-toc |
|---|---|
| Version | 1.2.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/markdown-toc |
| Homepage | https://github.com/jonschlinkert/markdown-toc |
| Repository | https://github.com/jonschlinkert/markdown-toc |
| Upstream docs | https://github.com/jonschlinkert/markdown-toc#readme |
| License | MIT |
| Source archive | https://registry.npmjs.org/markdown-toc/-/markdown-toc-1.2.0.tgz |
| Dependencies | node |
| Bottle | available (on all) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | markdown-toc |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
markdown-toc
nix profile install nixpkgs#markdown-toc- normalized package name match
- Matched by: Markdown Toc
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment