article-toc-generator

Generate and maintain Markdown article tables of contents with kebab-case anchors.

4|1|Updated Jan 11, 2018

Search Tags:#automation #markdown #anchors #blog #toc #headings #toc-generation

Ready to run

npx skills add https://github.com/izikeros/blog --skill article-toc-generator

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: article-toc-generator
Source: https://github.com/izikeros/blog/tree/main/.factory/skills/article-toc-generator
Command: npx skills add https://github.com/izikeros/blog --skill article-toc-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown articles often lack a navigable Table of Contents, require manual updating, and commonly accumulate legacy TOC markers that degrade readability.

Core Features & Use Cases

Generates a clean Table of Contents from level-2 and level-3 headings and inserts anchors above headings.
Removes legacy MarkdownTOC markers and migrates to a pure Markdown TOC.
Inserts the TOC after the front matter and ensures the document retains intro content.
Automatically triggers the article-post-edit-actions workflow after completion.

Quick Start

Invoke the article-toc-generator on a Markdown article to automatically insert a clean, anchor-enabled TOC after the front matter.

Frequently Asked Questions about article-toc-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automatically generate a Table of Contents for a Markdown blog article?▼

To generate a Table of Contents for a Markdown article, use a tool that parses level-2 and level-3 headings, inserts kebab-case anchor tags above them, and places the clean TOC directly after the front matter.

How do I remove legacy MarkdownTOC markers and migrate to a clean TOC?▼

To remove legacy MarkdownTOC markers and migrate to a clean TOC, use an automation tool that strips old markers, generates pure Markdown links from headings, and inserts the navigable TOC after the front matter.

Does this TOC generator work with Pelican-style static sites?▼

Yes, this TOC generator works with Pelican-style sites by enforcing front-matter placement, inserting kebab-case anchors above headings, and triggering the article-post-edit-actions workflow upon completion.

What is the best way to maintain heading anchors in Markdown without manual updates?▼

The best way to maintain heading anchors in Markdown without manual updates is to automate TOC generation, which enforces correct anchor insertion for level-2 and level-3 headings and removes legacy markers.

What heading levels are supported when generating a Markdown TOC?▼

When generating a Markdown TOC, level-2 and level-3 headings are supported. The tool parses these specific headings to create kebab-case anchors and builds a clean, navigable TOC after the front matter.