Non-English translations render escaped HTML as text and wrap bold headings in code blocks

[ff1451]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

The following pages are affected when viewed in any non-English language (e.g. Korean, Japanese, Spanish):

• https://docs.github.com/ko/actions/reference/runners/github-hosted-runners
• https://docs.github.com/ko/actions/reference/runners/github-hosted-runners#communication-requirements-for-github-hosted-runners

[english docs]

[korean(not english) docs ]

[english docs]

[korean(not english) docs ]

What changes are you suggesting?

Two rendering bugs affect all non-English translations of GitHub Actions runner documentation.

Bug 1: Raw HTML tags visible in tables

In translated pages, inline HTML elements such as <code><a href="...">ubuntu-latest</a></code> inside table <td> cells are displayed as literal text (e.g. <code>ubuntu-latest</code>) instead of being rendered as styled code elements.

This happens because the translation pipeline (Crowdin) entity-encodes angle brackets, turning <code> into <code>. The translation correction pipeline in src/languages/lib/correct-translation-content.ts does not unescape these HTML entities.

Bug 2: Bold headings rendered inside code blocks

Between code blocks, bold heading lines (e.g. **Needed for downloading actions:**) are wrapped in bare code fences (```) by the translation pipeline, causing them to render as code blocks instead of formatted headings.

Proposed fix:

Both bugs can be corrected in src/languages/lib/correct-translation-content.ts:

1. Unescape entity-encoded HTML tags (<code> → <code>) when the same tag appears as raw HTML in the English source.
2. Strip bare code-fence wrapping from lines that contain only a bold heading (**...**).

Additional information

Affected languages: All non-English translations (confirmed in Korean /ko).
Root cause: Crowdin translation pipeline corrupts inline HTML and markdown structure.
Browser: Reproducible in any browser (not a client-side issue).

[welcome]

Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[Sharra-writes]

@ff1451 I'm pretty sure I can submit this as a coherent but report. I've already marked it for that team, so hopefully they see it, but if they don't get to it by the time I have five or six localization issues, I'll just submit them all as bug reports and then close them here.