skills.rest
izikeros
izikerosCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/izikeros/blog --skill article-toc-generator
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
williamzujkowskiwilliamzujkowski
17

missing-level1

Detect missing Level 1 sections in Skill Unit documentation with YAML front matter.

Community
Basic
izikerosizikeros
4

article-seo-leo-enhancer

Inject SEO/LEO frontmatter fields into Markdown articles.

Community
Intermediate
DidierRLopesDidierRLopes
8

convert-beehiiv-newsletter

Convert Beehiiv newsletter posts into blog markdown files with front matter and images.

Community
Advanced
droxeydroxey
1

markdown-mode-router

Route markdown writing tasks to teaching or general formatting modes.

Community
Intermediate