This skill automates the complex process of migrating documentation from VitePress or standard GitHub repositories to Azure DevOps Wikis. It generates a zero-dependency Node.js script that recursively processes markdown files to resolve common rendering issues, such as incompatible Mermaid syntax, visible YAML front matter, and broken relative links. By creating a separate distribution directory, it ensures your source documentation remains pristine while providing a perfectly formatted output for Azure DevOps environments, complete with navigation order files and landing page optimization.
主要功能
01Transforms VitePress-specific containers like tips and warnings into Azure DevOps alert blocks.
02Strips YAML front matter to prevent raw metadata from rendering as visible text in the wiki.
03Generates ADO-specific .order files to maintain a consistent and logical sidebar navigation hierarchy.
04Resolves broken parent-relative source links and ensures a valid, high-quality index landing page.
051,777 GitHub stars
06Automatically converts Mermaid diagram syntax and flowchart keywords to ADO-supported formats.
使用场景
01Synchronizing GitHub READMEs and technical docs with Azure DevOps projects for team collaboration.
02Automating documentation transformation as part of a CI/CD pipeline to keep wikis up-to-date with source code.
03Migrating existing VitePress documentation sites to an internal Azure DevOps Wiki for enterprise visibility.