Can I use the generated script in a CI/CD pipeline?

Yes, the skill generates a standalone Node.js ESM module with no external dependencies, making it ideal for integration into automated build and deployment workflows.

How does it handle VitePress-specific features like tips and warnings?

It automatically detects VitePress container directives (::: tip, ::: warning, ::: danger) and converts them into the specific blockquote syntax required by Azure DevOps to display alerts correctly.

Does this skill modify my original markdown files?

No, the generated script creates transformed copies in a separate dist/ado-wiki/ directory, ensuring your original source files remain untouched.

Does it preserve directory structure and images?

Yes, the script maintains your existing directory hierarchy and copies non-markdown assets like images to the output folder so that relative paths continue to work.

Which Mermaid diagram types are supported after conversion?

It supports standard types like graph, sequenceDiagram, classDiagram, and stateDiagram, while automatically converting incompatible 'flowchart' syntax to the ADO-supported 'graph' format.

ADO Wiki Converter

Name: ADO Wiki Converter
Author: linehaul-ai

bylinehaul-ai

•

内容管理

Transforms VitePress and GitHub Flavored Markdown into Azure DevOps Wiki-compatible documentation scripts.

The ADO Wiki Converter bridges the gap between modern documentation frameworks like VitePress and the specific markdown requirements of Azure DevOps Wikis. It automates the complex conversion of Mermaid diagrams, strips problematic YAML front matter, and restructures navigation to ensure high-fidelity rendering within the Azure ecosystem. By generating a zero-dependency Node.js script, it allows teams to maintain a single source of truth for their documentation while seamlessly publishing to ADO without breaking links, diagrams, or callouts.

主要功能

01Non-destructive workflow that preserves source files while outputting transformed copies to a dist folder

02Intelligent navigation management through automatic .order file and index page generation

03Conversion of VitePress container directives into native ADO alert blockquotes

04Automated Mermaid syntax conversion including fence changes and flowchart-to-graph translation

05Removal of YAML front matter to prevent raw metadata rendering in the wiki interface

063 GitHub stars

使用场景

01Migrating GitHub-based technical documentation to an Azure environment without manual reformatting

02Syncing internal VitePress documentation sites with Azure DevOps Project Wikis for team visibility

03Automating documentation CI/CD pipelines to ensure ADO Wiki rendering remains consistent across updates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add linehaul-ai/linehaulai-claude-marketplace wiki-ado-convert

For use in Claude.ai and ChatGPT

Download Skill