markdown-content-formatter

Generate tables of contents and validate markdown structure for GitHub Flavored Markdown.

86|18|Updated Dec 14, 2025

Search Tags:#documentation #markdown #validation #formatting #content generation #static site

Ready to run

npx skills add https://github.com/dkyazzentwatwa/chatgpt-skills --skill markdown-content-formatter

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: markdown-content-formatter
Source: https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/markdown-content-formatter
Command: npx skills add https://github.com/dkyazzentwatwa/chatgpt-skills --skill markdown-content-formatter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown, pyyaml, beautifulsoup4, pandas, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the creation and maintenance of markdown content by automating formatting, validation, and conversion tasks, ensuring consistency and professionalism.

Core Features & Use Cases

Automated TOC Generation: Creates tables of contents based on heading structure.
Structure Validation: Checks for common markdown errors like skipped headings and broken links.
Flavor Conversion: Adapts markdown for different platforms (GitHub, Jekyll, Hugo).
Use Case: You have a long markdown document for a project's README. Use this Skill to automatically generate a table of contents, validate its structure for errors, and ensure it's formatted correctly for GitHub.

Quick Start

Use the markdown-content-formatter skill to generate a table of contents for the file 'document.md'.

Frequently Asked Questions about markdown-content-formatter

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

FAQPage Schema

What is the best way to format markdown content for a static site generator?▼

The best way to format markdown content for a static site generator is to use an automated formatter that generates tables of contents, validates structure, and converts between flavors. This Skill ensures your markdown meets platform-specific requirements deterministically.

How do I generate a table of contents for a long markdown document automatically?▼

To generate a table of contents for a markdown document, this Skill analyzes your heading structure and automatically inserts a linked TOC. It streamlines navigation for long files like project READMEs using Python scripts for deterministic formatting.

How do I validate markdown structure for broken links and skipped headings?▼

To validate markdown structure, this Skill scans your documents to detect common errors like skipped heading levels and broken links. It ensures your content maintains professional consistency and correct formatting before publication.

Can I convert markdown between GitHub Flavored Markdown, Jekyll, and Hugo formats?▼

Yes, you can convert markdown between GitHub Flavored Markdown, CommonMark, Jekyll, and Hugo formats. This Skill adapts your content syntax to match specific static site platform requirements, ensuring proper rendering across different environments.

Does this markdown formatter support adding frontmatter to existing documents?▼

Yes, this markdown formatter supports adding YAML frontmatter to your documents. It integrates with static site generators like Jekyll and Hugo by injecting necessary metadata headers while validating the overall document structure.

What is the best way to format markdown content for a static site generator?▼