wiki-ado-convert

Generate a Node.js build script converting wiki Markdown to Azure DevOps Wiki format.

Updated Aug 27, 2026

Search Tags:#markdown #mermaid #transformation #wiki #vitepress #ado-wiki

Ready to run

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

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts VitePress/GFM wiki markdown into Azure DevOps Wiki-compatible syntax, ensuring consistent rendering and link fidelity across the migration.

Core Features & Use Cases

Front matter stripping: Removes YAML front matter to prevent raw metadata from appearing in the wiki.
Mermaid normalization: Converts Mermaid fences to the ADO-compatible syntax, preserving diagram intent.
Link & asset normalization: Fixes relative links and ensures references render correctly in Azure DevOps Wikis.
Output isolation: Writes transformed copies to dist/ado-wiki/ while leaving source files untouched.
Use Case: Teams migrating internal wikis from VitePress/GFM to Azure DevOps can automate formatting and publication.

Quick Start

Run the build script to transform your wiki sources into the dist/ado-wiki output.

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 Node.js build script strips YAML front matter, normalizes Mermaid blocks, fixes broken links, and writes transformed copies to the dist/ado-wiki/ directory.

Why does YAML front matter show up as raw text in Azure DevOps Wikis?▼

YAML front matter appears as raw text in Azure DevOps Wikis because ADO does not parse it natively. The conversion process strips this metadata to prevent it from rendering visibly on the wiki page.

Can I migrate Mermaid diagrams from a GitHub Wiki to Azure DevOps Wiki?▼

Yes, you can migrate Mermaid diagrams from a GitHub Wiki to Azure DevOps Wiki. The transformation process converts standard Mermaid fences into the ADO-compatible syntax to preserve diagram intent.

Does converting markdown for Azure DevOps Wiki modify my original source files?▼

Converting markdown for Azure DevOps Wiki does not modify original source files. The build script ensures output isolation by writing all transformed markdown copies to a separate dist/ado-wiki/ directory.

What's the best way to fix broken relative links when migrating to Azure DevOps Wiki?▼

The best way to fix broken relative links during Azure DevOps Wiki migration is to run an automated build script that normalizes asset references and links, ensuring they render correctly in the target ADO Wiki.