Can I run the resulting script in a CI/CD pipeline?

Yes, the generated script is a standard Node.js ESM module with zero external dependencies, making it lightweight and ideal for automated build environments.

What happens to images and non-markdown files?

The script is designed to copy images and other assets to the destination folder while preserving their relative paths so that all visual elements render correctly in the wiki.

Does this skill modify my original documentation files?

No, the generated script creates transformed copies in a separate 'dist/ado-wiki/' folder, ensuring your source documentation remains untouched.

How does it handle the sidebar navigation in Azure DevOps?

The script automatically generates '.order' files for every directory, which Azure DevOps uses to determine the sequence and hierarchy of pages in the sidebar.

Which Mermaid diagram types are supported after conversion?

It supports standard types including sequenceDiagram, gantt, graph, classDiagram, and stateDiagram, while specifically fixing incompatible 'flowchart' syntax used in GFM.

ADO Wiki Converter

Name: ADO Wiki Converter
Author: microsoft

bymicrosoft

•

1,777

•

콘텐츠 관리

Converts VitePress and GitHub Flavored Markdown documentation into Azure DevOps Wiki-compatible formats using an automated Node.js build script.

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.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microsoft/skills wiki-ado-convert

For use in Claude.ai and ChatGPT

Download Skill