wiki-markdown-structure-gate

To validate wiki markdown structure before publishing, run a pre-publish gate that checks for balanced code and callout fences, table separator rows, heading hierarchy order, and escaped internal-link artifacts. It outputs a line-numbered report of BLOCK or WARN findings for editors to fix.

Broken wiki pages with malformed tables and unbalanced code fences are caused by collapsed table rows, missing separator rows, and unclosed callout or code blocks. Detecting these structural defects requires deterministic checks that report line numbers before the page reaches production.

To check markdown heading hierarchy and table separators in bulk wiki pipelines, apply deterministic lint checks at a pre-publish stage. The gate enforces heading level order and validates table separator rows, producing line-numbered BLOCK findings to halt publication of defective pages.

Wiki markdown validation requires a platform adapter that exposes toc_behavior to enforce manual TOC requirements. If the adapter configuration is missing, the validation fails closed to prevent publishing pages without a proper table of contents.

Escaped internal-link artifacts block wiki page publication because they create broken internal links when rendered. The markdown structure gate detects these artifacts and reports them as BLOCK findings, requiring editors to remove the escape characters before the page can pass validation.

You can use a markdown lint gate for wiki pages with toggles and callouts by running deterministic checks for balanced callout fences. The gate detects unclosed or malformed callout blocks and reports them as line-numbered findings before the page enters the publish pipeline.