[zh-cn] update 'how to write in markdown' #32820
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
github-project-automation
bot
moved this to Review requested
in MDN translated-content l10n-zh
Contributor
|
Preview URLs (1 page) External URLs (1)URL:
|
PassionPenguin
suggested changes
Jan 30, 2026
Contributor
PassionPenguin
left a comment
PassionPenguin
left a comment
There was a problem hiding this comment.
有几个地方有额外的更改，需要同步
还有更多内容（从 GFM Callouts 往后）因为前文乱序，后文有点难对上，我就没有看，可能也有部分修改
| 如果你希望高亮显示的语言未在上方列出，请使用 `plain` 标记代码块。也可以按照 [GitHub 讨论](https://github.com/orgs/mdn/discussions/170#discussioncomment-3404366)提出的流程请求其他语言的高亮支持。 | ||
|
|
||
| > [!NOTE] | ||
| > 请严格按照上述列表使用语言标识符。例如，`javascript` 是不被允许的，必须使用 `js`。 |
Contributor
There was a problem hiding this comment.
Suggested change
| > 请严格按照上述列表使用语言标识符。例如，`javascript` 是不被允许的，必须使用 `js`。 | |
| > 请严格按照上述列表使用语言标识符。例如，你不应使用 `javascript`，而必须使用 `js`。 |
| sourceCommit: 49f3eb321cf6a491c3bcef1c3590f9bf6f90c9b8 | ||
| --- | ||
|
|
||
| 本文介绍了如何使用 Markdown 来编写 MDN Web 文档项目中的文档。我们以 GitHub 风格的 Markdown（GFM）为基础，并添加了一些扩展来支持一些我们在 MDN 上需要而 GFM 仍不支持的东西。 |
Contributor
There was a problem hiding this comment.
Suggested change
| 本文介绍了如何使用 Markdown 来编写 MDN Web 文档项目中的文档。我们以 GitHub 风格的 Markdown（GFM）为基础，并添加了一些扩展来支持一些我们在 MDN 上需要而 GFM 仍不支持的东西。 | |
| 本文介绍了如何使用 Markdown 来编写 MDN Web 文档项目中的文档。我们以 GitHub 风格的 Markdown（GFM）为基础，并添加了部分扩展来支持一些我们在 MDN 上需要的特性。 |
Contributor
There was a problem hiding this comment.
老师，原文L22-L24应当是一个段落，辛苦修改
On MDN we prefer to use inline links because they are easier to read and maintain without losing context. This is the preferred way to write links on MDN:
| @@ -34,21 +35,23 @@ GFM 规范定义了两种基础的链接类型： | |||
| [马卡龙]: https://zh.wikipedia.org/wiki/馬卡龍 | |||
| @@ -90,7 +94,7 @@ GFM 规范定义了两种基础的链接类型： | |||
| - `toml`——TOML | |||
Contributor
There was a problem hiding this comment.
powershell- PowerShellwat- WebAssemblybash- Bash/Shellhbs- Handlebars templates
github-project-automation
bot
moved this from Review requested
to In progress - PRs
in MDN translated-content l10n-zh
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Motivation
Additional details
Related issues and pull requests