diff options
author | YC L <liuyuchen1@i.pkuschool.edu.cn> | 2019-05-11 20:48:14 +0800 |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-05-11 20:48:14 +0800 |
commit | 0c12bfb20cce4868402be99ae4fc05defdbf0ac2 (patch) | |
tree | 87b8c7a2dad32047b17e4f162a0f3467d7ca3a6b | |
parent | 30bc3f244b8f6f96d1d4f10753c06110c2a063d8 (diff) |
[Markdown/zh-cn] More Examples and visualization
Known issue: "HTML标签"的目录链接不工作
-rw-r--r-- | zh-cn/markdown-cn.html.markdown | 58 |
1 files changed, 45 insertions, 13 deletions
diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown index 2bd8d11a..9b3d96ab 100644 --- 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 的摘要笔记。 |