wiki-ado-convert

Topics in the source

• ADO Wiki Converter
• Source Repository Resolution (MUST DO FIRST)
• Why This Is Needed
• ADO Wiki Incompatibilities
• CRITICAL — Will Break Rendering
• MODERATE — May Not Render Optimally
• NOT AN ISSUE (Compatible As-Is)
• ADO Wiki Mermaid Supported Diagram Types

Generate a Node.js build script that transforms VitePress/GFM markdown documentation into Azure DevOps Wiki-compatible format. The source files remain untouched — the script produces transformed copies in dist/ado-wiki/. Before generating the build script, resolve the source repository context: 1. Check for git remote: Run git remote get-url origin 2. Ask the user: "Is this a local-only repository, or do you have a source repository URL?" Remote URL → store as REPOURL, preserve linked citations in converted output Local → preserve local citations as-is 3. Do NOT proceed until resolved Azure DevOps Wikis use a markdown dialect that differs from GFM and VitePress in several critical ways. Documentation that renders perfectly in VitePress will have broken diagrams, raw front matter, dead links, and rendering issues when published as an ADO Wiki. | Issue | VitePress/GFM | ADO Wiki | Fix | |-------|--------------|----------|-----| | Mermaid code fences | mermaid ... | ::: mermaid ... ::: | Convert opening/closing fences | | flowchart keyword | flowchart TD | graph TD | Replace flowchart with graph (preserve direction) | | in Mermaid labels | Node[Label Text] | Not supported | Strip vari

This is an excerpt. Refer to the complete source and its current requirements.