Azure DevOps Wiki Markdown

Route Azure DevOps Markdown questions to the right reference, with extra depth on wiki-only blocks, Mermaid-safe authoring, and code-fence language identifiers.

Verified against Microsoft Learn Azure DevOps Markdown guidance, the Azure Repos Sprint 259 release note, and the current Highlight.js supported-language table on April 9, 2026.

Decision Tree

What do you need to do?

• Draft or repair a normal wiki page -> read references/syntax.md
• Check whether a feature works in Done, Widget, PR, README, or Wiki -> read references/support-matrix.md
• Use wiki-only features such as [[_TOSP_]], <details>, query-table, @ mentions, KaTeX, or video embeds -> read references/advanced-features.md
• Draft a proposal decision tree for a plan, rollout, ADR, or dependency discussion -> read references/decision-trees.md and templates/decision-tree-proposal.md
• Create or debug a Mermaid diagram -> read references/mermaid.md
• Pick a fenced-code language tag or alias -> read references/code-languages.md and optionally run python3 scripts/find_code_language.py <query>
• Diagnose Azure DevOps-specific rendering surprises -> read references/gotchas.md

Quick Reference