{"adoption": {"forks": 712, "observed_at": "2026-08-28T04:05:32.153417+00:00", "stars": 1756}, "canonical_url": "https://ross.abutalabs.com/products/markdown-toc", "card": {"archived": false, "artifact_type": "library", "description": "API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects.", "domain": ["documentation", "developer-tools"], "enriched": true, "function": ["markdown", "parser", "cli", "documentation", "developer-tools"], "health_score": 20, "homepage": "https://github.com/jonschlinkert", "language": "JavaScript", "license": "MIT", "license_family": "permissive", "maturity": "maintenance", "member_repos": ["jonschlinkert/markdown-toc"], "name": "jonschlinkert/markdown-toc", "platform": ["cli", "cross-platform"], "pushed_at": "2024-08-09T14:53:13+00:00", "repo": "jonschlinkert/markdown-toc", "stars": 1756, "tags": ["table-of-contents", "toc-generator", "remarkable", "readme", "npm-package", "command-line", "nodejs"], "topics": ["toc-generator", "table-of-contents", "toc", "markdown", "navigation", "project", "readme", "md", "markdown-toc", "node", "nodejs", "javascript", "jonschlinkert", "remarkable"], "urls": [], "use_cases": ["generate a table of contents for a README", "auto-insert TOC into markdown docs", "extract heading structure from a markdown file as JSON", "add navigation links to documentation", "keep README TOC in sync with headings via a script"], "what_it_is": "A Node.js library and CLI that generates a table of contents for markdown files like READMEs, using Remarkable to parse headings. It can inject the TOC directly into a file at a <!-- toc --> marker and also exposes a JSON API.", "when_to_avoid": ["you need a full static site generator or docs framework", "your project uses MDX or non-standard markdown syntax Remarkable may not handle", "you need actively developed features rather than a stable maintenance-mode tool"], "when_to_choose": ["you maintain markdown docs or READMEs and want an auto-generated, linkable TOC", "you need a programmatic API to extract markdown heading structure", "you want a simple CLI to inject a TOC at a marker in place"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/markdown-toc", "repo": "jonschlinkert/markdown-toc", "role": "main", "score": 32}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:05:32.153417+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T03:27:52.265875+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "99a410d61afa470516162ab3ed39a14322d1f6bfbfbbf173045dac89b2b84d0c", "fetched_at": "2026-08-28T04:05:32.153417+00:00", "kind": "readme", "missing": false, "url": "https://github.com/jonschlinkert/markdown-toc"}, {"content_hash": "5ff17830cf36e506e7df6e354b75edc03e6d43697d84243a3b459fa4d30fc862", "fetched_at": "2026-08-29T11:06:14.029976+00:00", "kind": "homepage", "missing": false, "url": "https://github.com/jonschlinkert"}, {"content_hash": "0dfa2f0b2ce8f724fd123b3854670a44766f105c2c1254748a89e1005ed2f3a5", "fetched_at": "2026-08-29T11:06:14.038954+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/markdown-toc"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 0, "longevity": 100, "rhythm": 35}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_releases"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 4681, "days_push": 754, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 32, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}