C✳CODEZ.WIN
🌐 English

Localized reading guide

wiki-ado-convertPurpose, usage and source

Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format. Generates a Node.js build script that transforms Mermaid syntax, strips front matter, fixes links, and outputs ADO-compatible copies to dist/ado-wiki/.

Source retrieved:

Source repository
microsoft/skills
SKILL.md
.github/plugins/deep-wiki/skills/wiki-ado-convert/SKILL.md
Repository stars
3,157
Repository updated
2026-10-31
Categories
Integrations
Last collected

License: MIT

Source SKILL.md

Workflow excerpts are reading aids, not executable instructions from Codez. No third-party Skill was run to produce this page.

The purpose and workflow passages below are upstream material, organized and translated for reading. They are distinct from the separately labeled Codez editorial analysis.

What this Skill does

Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format. Generates a Node.js build script that transforms Mermaid syntax, strips front matter, fixes links, and outputs ADO-compatible copies to dist/ado-wiki/.

How the upstream workflow works

ADO Wiki Converter

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/.

Upstream passage · L10 ↗

Source Repository Resolution (MUST DO FIRST)

Before generating the build script, resolve the source repository context: Check for git remote: Run git remote get-url origin

Upstream passage · L14 ↗

Why This Is Needed

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.

Upstream passage · L24 ↗
Upstream passage · javascript ↗
function stripFrontMatter(content) {
  if (!content.startsWith('---')) return content;
  const endIndex = content.indexOf('\n---', 3);
  if (endIndex === -1) return content;
  let rest = content.slice(endIndex + 4);
  if (rest.startsWith('\n')) rest = rest.slice(1);
  return rest;
}

Requirements and setup

NOT AN ISSUE (Compatible As-Is)

✅ Standard markdown tables, blockquotes, horizontal rules ✅ Unicode emoji, fenced code blocks with language identifiers

Upstream passage · L51 ↗

Limits and quality checks

Important Notes

Source files are NEVER modified — only copies in dist/ado-wiki/ Images must be copied too — if source has images, copy them with same relative paths

Upstream passage · L242 ↗

Start with a safe trial

  1. Check the supported host and the repository installation instructions. Keep the Skill directory and its referenced scripts, assets and documentation together; SKILL.md alone may omit dependencies.
  2. Give the agent your real input, desired output and acceptance criteria. Invocation syntax and available tools depend on the host; this site does not assume a universal install command.
  3. Try the source workflow in a disposable project or on a copy. Review operations that change files, remote services or billable resources before allowing them.
  4. Validate the output against the source quality checks and your own requirements. A successful trigger or a high repository Star count does not establish a correct result.

Skill format and directory specification ↗

Read further in the source

Translation and scope

This reading guide selects passages from the pinned upstream SKILL.md. Translation is assisted. It is not a complete manual or a claim of tested compatibility. Read the original and its referenced files before use.

This introduction refers to the pinned version below; current repository activity and collection time are shown separately.

Source retrieved
Source commit
00d66a64919edca5bca2c673373444e36a4b5461
Source SHA-256
afb330d4d5b43c470e83693ef73caee21f99c149dd5011f8543c424a751cebc3
Back to the full Skill catalog