wiki-ado-convert

Name: wiki-ado-convert
Availability: InStock
Author: Microsoft

Convert VitePress/GFM markdown to Azure DevOps Wiki format via a Node.js build script.

2.9k|323|Updated Jan 16, 2026

Search Tags:#markdown #wiki #convert #azure-devops #vitepress #build-script

Ready to run

npx skills add https://github.com/microsoft/skills --skill wiki-ado-convert

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: wiki-ado-convert
Source: https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert
Command: npx skills add https://github.com/microsoft/skills --skill wiki-ado-convert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format. Generates a Node.js build script that transforms Mermaid syntax, strips front matter, fixes links, and outputs ADO-compatible copies to dist/ado-wiki/.

Core Features & Use Cases

Generates a Node.js build script that performs transformations on markdown files, leaving source untouched and writing transformed copies to dist/ado-wiki/.
Handles Mermaid diagrams, front matter stripping, link corrections, and asset preservation to ensure compatibility with Azure DevOps Wikis.
Example: migrate your project's wiki from VitePress to ADO Wiki with a single build run.

Quick Start

Run the build script to generate the ADO wiki from your VitePress source.

Frequently Asked Questions about wiki-ado-convert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I convert VitePress markdown to Azure DevOps Wiki format?▼

To convert VitePress markdown to Azure DevOps Wiki format, a generated Node.js build script transforms Mermaid syntax, strips YAML front matter, and fixes internal links. It outputs ADO-compatible copies to the dist/ado-wiki/ directory while preserving source files.

What is the best way to migrate documentation from VitePress to Azure DevOps Wiki?▼

The best way to migrate VitePress documentation to Azure DevOps Wiki is running a generated build script that produces ADO-compatible markdown copies. This script handles Mermaid diagrams, front matter stripping, and link corrections automatically in a single build run.

Does the Azure DevOps Wiki conversion script modify my original VitePress source files?▼

No, the Azure DevOps Wiki conversion script does not modify original VitePress source files. It performs transformations on markdown files and writes the ADO-compatible output copies to a separate dist/ado-wiki/ directory, leaving your source untouched.

Do I need external npm dependencies to build Azure DevOps Wiki files from VitePress?▼

You do not need external npm dependencies to build Azure DevOps Wiki files from VitePress. The generated Node.js build script uses only built-in Node.js modules to perform markdown transformations and output the converted wiki content.

Can I keep Mermaid diagrams and internal links when converting VitePress to ADO Wiki?▼

Yes, you can keep Mermaid diagrams and internal links when converting VitePress to ADO Wiki. The build script transforms Mermaid blocks and fixes internal links to ensure compatibility within the Azure DevOps Wiki environment.

Why does VitePress YAML front matter break Azure DevOps Wiki pages?▼

VitePress YAML front matter breaks Azure DevOps Wiki pages because ADO Wiki does not natively parse or render front matter blocks. The conversion script resolves this by stripping YAML front matter during the markdown transformation process.