-
Notifications
You must be signed in to change notification settings - Fork 66.7k
link blocks render incorrectly in non-English localized docs pages #43703
Description
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?
Multiple localized versions of GitHub Docs pages are affected.
For example:
-
English (correct rendering):
https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-open-source -
Chinese (Simplified):
https://docs.github.com/zh/get-started/exploring-projects-on-github/contributing-to-open-source -
Japanese:
https://docs.github.com/ja/get-started/exploring-projects-on-github/contributing-to-open-source
This issue appears in multiple localized pages, not limited to a single article.
What part(s) of the article would you like to see updated?
In non-English localized versions (e.g., Chinese and Japanese), some inline Markdown links are incorrectly rendered as code blocks.
Problem details
The Markdown link [text](url) is wrapped inside a code block (```), causing it to render as plain text instead of a clickable link.
This breaks usability because users cannot click through to referenced documentation.
Expected behavior
- Links should render as normal inline links (not inside code blocks).
- Localization should preserve correct Markdown structure.
- Links should remain clickable and consistent with the English version.
Why this should be fixed
- Affects usability of documentation for non-English users.
- Prevents navigation to related docs.
- Likely a systematic localization or Markdown processing issue affecting multiple pages.
Additional information
- Yes, the issue is reliably reproducible.
- It occurs consistently on multiple localized pages (e.g., Chinese and Japanese versions).
- This suggests a broader issue in the localization pipeline or Markdown rendering process.
- The problem is not isolated and may affect many users who rely on non-English documentation.
Expected (English original):
Actual (Chinese translation):
Actual (Japanese translation):
Actual (Korea translation):
