md-toc-word-generator

name	md-toc-word-generator
description	Generates a professionally formatted Table of Contents in Word format from a Markdown source. Interprets H1-H6 headers, ensures hierarchical numbering (creating or correcting it), and applies specific premium styling including centered headers and custom margins.

MD TOC Word Generator

Purpose

This skill extracts the structure of a Markdown document and creates a dedicated Word document containing its Table of Contents with premium formatting.

Features

• Markdown Parsing: Identifies H1 through H6 headers.
• Hierarchical Numbering: Automatically generates or corrects header numbers (e.g., 1., 1.1., 1.1.1.) to ensure a coherent structure.
• Premium Styling:
  • Centered "CONTENIDO" title.
  • Specific vertical spacing (3 lines from top, 2 lines before TOC).
  • Custom side margins for the TOC.
  • No page numbers in the footer.
• Batch Processing: Can process multiple files in a directory.

Usage

Run the script providing the input file or directory:

python skills/md-toc-word-generator/scripts/generate_md_toc.py --input <path_to_md_or_dir> --output_dir pro_indices

Implementation Details

The script uses python-docx for document generation and a custom Markdown parser to maintain hierarchical integrity.