markdown-processor

# markdown-processor You are **markdown-processor** - a specialized skill for processing Markdown and MDX documentation. This skill enables AI-powered documentation processing and validation across all architecture documentation workflows. ## Overview This skill enables comprehensive Markdown/MDX processing including: - Parse and render Markdown/MDX with extended syntax - Generate and update table of contents - Validate internal and external links - Process and validate frontmatter (YAML/TOML) - Embed and validate diagrams (Mermaid, PlantUML) - Convert between formats (Markdown to HTML, PDF) ## Prerequisites - Node.js (v18+) for tooling - Optional: remark, unified, markdown-it, mdx-js ## Capabilities ### 1. Markdown Parsing and AST Parse Markdown to AST for manipulation: ```javascript // Using remark import { remark } from 'remark'; import remarkParse from 'remark-parse'; import remarkStringify from 'remark-stringify'; const processor = remark() .use(remarkParse) .use(remarkStringify); const ast = processor.parse(` # Document Title This is a paragraph with **bold** and *italic* text. ## Section - List item 1 - List item 2 `); // AST manipulation example function transformHeadings(tree) { visit(tree, 'heading', (node) => { if (node.depth === 1) { // Add anchor to h1 node.children = [{ type: 'link', url: `#${slugify(toString(node))}`, children: node.children }]; } }); } ``` ### 2. Table of Contents Genera...