[Markdown/zh-cn] More Examples and visualization

Known issue: "HTML标签"的目录链接不工作
2025-07-31 03:50:32 +02:00 · 2019-05-11 20:48:14 +08:00
parent 30bc3f244b
commit 0c12bfb20c
1 changed files with 45 additions and 13 deletions
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -5,6 +5,7 @@ contributors:
 translators:
    - ["Fangzhou Chen","https://github.com/FZSS"]
    - ["Luffy Zhong", "https://github.com/mengzhongshi"]
+    - ["Yuchen Liu", "https://github.com/smallg0at"]
 filename: learnmarkdown-cn.md
 lang: zh-cn
 ---
@@ -46,6 +47,16 @@ Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown
 ##### 这是一个 <h5>
 ###### 这是一个 <h6>
 ```
+
+实际效果（最终显示时会因设置而看起来不同）：
+# 这是一个
+## 这也是一个
+### 这还是一个
+#### 这依旧是一个
+##### 这真的是一个
+###### 这...是一个
+
+
 对于 `<h1>` 和 `<h2>` 元素，Markdown 额外提供了两种添加方式。

 ```md
@@ -58,7 +69,7 @@ Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown

 ## 文本样式

-文本的斜体，粗体在 Markdown 中可以轻易实现。
+文本的*斜体*，**粗体**在 Markdown 中可以轻易实现。

 ```md
 *此文本为斜体。*
@@ -72,7 +83,7 @@ __此文本也是__
 *__这个也是！__*
 ```

-GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以使用删除线：
+GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以使用~~删除线~~：

 ```md
 ~~此文本为删除线效果。~~
@@ -80,6 +91,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
 ## 段落

 段落由一个句子或是多个中间没有空行的句子组成，每个段落由一个或是多个空行分隔开来。
+（注：部分解析器有无需空行就能换行的设置，这个主要看个人喜好）

 ```md
 这是第一段落. 这句话在同一个段落里，好玩么？
@@ -92,7 +104,9 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
 ```

 如果你想插入一个 `<br />` 标签，你可以在段末加入两个以上的空格，然后另起一
-段。(译者注：试了一下，很多解析器，并不需要空两个空格，直接换行就会添加一个`<br />`)
+段。
+
+(译者注：试了一下，很多解析器，并不需要空两个空格，直接换行就会添加一个`<br />`)

 ```md
 此段落结尾有两个空格（选中以显示）。  
@@ -102,6 +116,8 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以

 段落引用可由 `>` 字符轻松实现。

+> 对的很轻松
+
 ```md
 > 这是一个段落引用。 你可以
 > 手动断开你的句子，然后在每句句子前面添加 `>` 字符。或者让你的句子变得很长，以至于他们自动得换行。
@@ -113,7 +129,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
 ```

 ## 列表
-无序列表可由星号，加号或者减号来创建
+- 无序列表可由星号，加号或者减号来创建

 ```md
 * 项目
@@ -172,6 +188,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
 下面这个选择框将会是选中状态
 - [x] 这个任务已经完成
 ```
+- [ ] 你看完了这个任务（注：此选择框是无法直接更改的，即禁用状态。）

 ## 代码块

@@ -217,7 +234,10 @@ end
 ---
 - - - 
 ****************
+
+下面这个就是示例
 ```
+---

 ## 链接

@@ -294,33 +314,45 @@ Markdown同样支持引用形式的链接
 我希望 *将这段文字置于星号之间* 但是我不希望它被
 斜体化, 这么做: \*这段置文字于星号之间\*。
 ```
+对比一下：*将这段文字置于星号之间* 和 \*将这段文字置于星号之间\*

 ### 键盘上的功能键

-在 GitHub 的 Markdown中，你可以使用 `<kbd>` 标签来表示功能键。
+在 GitHub 的 Markdown 中，你可以使用 `<kbd>` 标签来表示功能键。

 ```md
 你的电脑死机了？试试
 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
 ```
 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
+
+（译注：可能由于网站本身样式问题，效果不明显）
+
 ### 表格

-表格只被 GitHub 的 Markdown 支持，并且有一点笨重，但如果你真的要用的话: (译者注：其实现在大部分markdown都已经支持)
+下面示例的表格长这样：
+
+| 第一列        | 第二列    | 第三列       |
+| :----------- | :-------: | ----------: |
+| 我是左对齐    | 居个中    | 右对齐       |
+| 注意          | 冒       | 号           |
+
+工整一点的写法是这样的：

 ```md
 | 第一列        | 第二列    | 第三列       |
-| :---------   | :------: | ----------: |
-| 左对齐        | 居个中    | 右对齐       |
-| 某某某        | 某某某    | 某某某       |
+| :----------- | :-------: | ----------: |
+| 我是左对齐    | 居个中    | 右对齐       |
+| 注意          | 冒       | 号           |
 ```
-
-或者, 同样的
+好吧，强行对齐字符是很难的。但是，至少比下面这种写法好一点——

 ```md
-第一列 | 第二列 | 第三列
+我是超级超级长的第一列 | 第二列 | 第三列
 :-- | :-: | --:
-这太丑了 | 药不能 | 停
+这真的太丑了 | 药不能 | 停！！！！
 ```
+真的是*看着令人头晕*
+

 更多信息, 请于[此处](http://daringfireball.net/projects/Markdown/syntax)参见 John Gruber 关于语法的官方帖子，及于[此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet) 参见 Adam Pritchard 的摘要笔记。