DocFX is a .NET-based documentation generator that creates static HTML websites from Markdown, YAML metadata, .NET API comments, and REST API specifications. It features a modular architecture with a plugin system for extensibility, processing pipelines for different document types (conceptual, managed reference, REST API), and a template engine for customizable output. The system processes input files through metadata extraction, template application, and post-processing to generate documentation sites. Key components include a command-line interface (docfx.exe), build orchestration, schema-driven document validation, cross-reference resolution, and resource handling. The tool supports multiple templates (default, modern, statictoc) and output formats including HTML and PDF via Playwright rendering.
This repository is a TypeScript monorepo of 40+ markdown-it plugins, published as individual @mdit/plugin-* npm packages plus the @mdit/helper utility package. It is a developer-facing library ecosystem, not an application: each plugin extends markdown-it with additional Markdown syntax and rendering behavior, including alerts, containers, tabs, footnotes, task lists, definition lists, abbreviations, emoji, math (KaTeX and MathJax with full and slim variants), diagrams (PlantUML/UML), image controls (size, lazyload, mark), advanced links, attribute syntax, icons, layout directives (flex/grid/columns), file include/snippet (Node-only, file-system based), and text semantics (sub, sup, mark, ins, ruby, spoiler). The plugins are consumed primarily by static-site generators such as VuePress/VitePress and by any Node or browser pipeline that renders Markdown via markdown-it.