skills.rest
rrbanda
rrbandaCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/rrbanda/skills --skill wiki-ado-convert-rrbanda
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
microsoftmicrosoft
2.9k

wiki-ado-convert

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

Official
Advanced
javatarzjavatarz
4

wiki

Manage a local GitHub Wiki clone for reading, updating, and pushing content.

Community
Advanced
kriscendobotkriscendobot
3

mermaid-validation

Validate Mermaid diagram syntax in markdown files using a headless Node.js environment.

Community
Intermediate
georgekhananaevgeorgekhananaev
27

md

Enforce consistent Markdown syntax across documentation and README files.

Community
Basic