MS Minseok Song

Developer Tools

Fixing Broken Markdown in AI Translation

Hardening Co-op Translator after real Markdown failures in multilingual documentation.

Minseok Song Minseok Song Microsoft AI MVP ยท Founder of Localizeflow

Updated Apr 30, 2026 / 1 min read

#co-op-translator #markdown #localization #production-llms

This post came from a very practical kind of failure.

Community feedback around Japanese translations showed me that many AI translation problems were not semantic. The translation could sound reasonable, but the document could still be broken because anchors, code blocks, lists, links, frontmatter, or formatting structure had drifted.

That changed how I thought about Co-op Translator. I stopped treating the output as text and started treating it as a software artifact that needed structure, state, and recovery paths.

What stayed with me is that generated documentation only earns trust when the system around it protects reviewability. The model matters, but the pipeline around the model decides whether maintainers can actually use the result.

Read the original article:

Fixing Broken Markdown in AI Translation: Hardening a Production Pipeline