wiki-ado-convert

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.

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.

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.

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.

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.

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.