info/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-08-09 00:06:47 +02:00
Code Issues Releases Wiki Activity

Update the translation

Browse Source 
The translation is outdated, so I try to update it.
This commit is contained in:
luffy_zhong
2018-07-04 17:10:32 +08:00
committed by GitHub
parent a5f04d7e53
commit 6261f85b2f
1 changed files with 163 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

236
zh-cn/markdown-cn.html.markdown
View File

@@ -10,39 +10,56 @@ lang: zh-cn
Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的语法结构，并可以便利地转换成 HTML（以及其他很多）格式。 Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的语法结构，并可以便利地转换成 HTML（以及其他很多）格式。
欢迎您多多反馈以及分支和请求合并。 在不同的解析器中，Markdown 的实现方法有所不同。
此教程会指出哪些特征是通用，哪一些只对某一解析器有效。
- [HTML标签](#html-elements)
- [标题](#headings)
- [文本样式](#simple-text-styles)
- [段落](#paragraphs)
- [列表](#lists)
- [代码块](#code-blocks)
- [水平线分隔](#horizontal-rule)
- [链接](#links)
- [图片](#images)
- [杂项](#miscellany)
## HTML标签
Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown。
```md ```md
<!-- Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown。 <!--这意味着我们可以在 Markdown 里使用任何 HTML 元素，比如注释元素，
这意味着我们可以在 Markdown 里使用任何 HTML 元素，比如注释元素，
且不会被 Markdown 解析器所影响。不过如果你在 Markdown 文件内创建了 HTML 元素， 且不会被 Markdown 解析器所影响。不过如果你在 Markdown 文件内创建了 HTML 元素，
你将无法在 HTML 元素的内容中使用 Markdown 语法。--> 你将无法在 HTML 元素的内容中使用 Markdown 语法。-->
```
<!-- 在不同的解析器中，Markdown 的实现方法有所不同。 ## 标题
此教程会指出当某功能是否通用及是否只对某一解析器有效。 -->
<!-- 标头 --> 通过在文本前加上不同数量的hash(#), 你可以创建相对应的 `<h1>` 到 `<h6>` HTML元素。
<!-- 通过在文本前加上不同数量的hash(#), 你可以创建相对应的 <h1>
到 <h6> HTML元素。-->
```md
# 这是一个 <h1> # 这是一个 <h1>
## 这是一个 <h2> ## 这是一个 <h2>
### 这是一个 <h3> ### 这是一个 <h3>
#### 这是一个 <h4> #### 这是一个 <h4>
##### 这是一个 <h5> ##### 这是一个 <h5>
###### 这是一个 <h6> ###### 这是一个 <h6>
```
对于 `<h1>` 和 `<h2>` 元素，Markdown 额外提供了两种添加方式。
<!-- 对于 <h1> 和 <h2> 元素，Markdown 额外提供了两种添加方式。 --> ```md
这是一个 h1 这是一个 h1
============= =============
这是一个 h2 这是一个 h2
------------- -------------
```
<!-- 简易文本样式 --> ## 文本样式
<!-- 文本的斜体，粗体，和删除线在 Markdown 中可以轻易地被实现。-->
文本的斜体，粗体在 Markdown 中可以轻易实现。
```md
*此文本为斜体。* *此文本为斜体。*
_此文本也是。_ _此文本也是。_
@@ -52,40 +69,54 @@ __此文本也是__
***此文本是斜体加粗体。*** ***此文本是斜体加粗体。***
**_或者这样。_** **_或者这样。_**
*__这个也是！__* *__这个也是！__*
```
<!-- 在 GitHub 采用的 Markdown 中 --> GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以使用删除线：
```md
~~此文本为删除线效果。~~ ~~此文本为删除线效果。~~
```
## 段落
<!-- 单个段落由一句或多句邻近的句子组成，这些句子由一个或多个空格分隔。--> Paragraphs are a one or multiple adjacent lines of text separated by one or
multiple blank lines.
段落由一个句子或是多个中间没有空行的句子组成，每个段落由一个或是多个空行分隔开来。
```md
这是第一段落. 这句话在同一个段落里，好玩么？ 这是第一段落. 这句话在同一个段落里，好玩么？
现在我是第二段落。 现在我是第二段落。
这句话也在第二段落！ 这句话也在第二段落！
这句话在第三段落！ 这句话在第三段落！
```
<!-- 如果你插入一个 HTML中的<br />标签，你可以在段末加入两个以上的空格， 如果你插入一个 HTML中的<br />标签，你可以在段末加入两个以上的空格，然后另起一段。
然后另起一段。--> (译者注：试了一下，很多解析器，并不需要空两个空格，直接换行就会添加一个`<br />`)
```md
此段落结尾有两个空格（选中以显示）。 此段落结尾有两个空格（选中以显示）。
上文有一个 <br /> ！ 上文有一个 <br /> ！
```
<!-- 段落引用可由 > 字符轻松实现。--> 段落引用可由 `>` 字符轻松实现。
> 这是一个段落引用. 你可以 ```md
> 手动断开你的句子，然后在每句句子前面添加 “>” 字符。或者让你的句子变得很长，以至于他们自动得断开。 > 这是一个段落引用。 你可以
> 只要你的文字以“>” 字符开头，两种方式无异。 > 手动断开你的句子，然后在每句句子前面添加 `>` 字符。或者让你的句子变得很长，以至于他们自动得换行。
> 只要你的文字以 `>` 字符开头，两种方式无异。
> 你也对文本进行 > 你也可以对文本进行
>> 多层引用 >> 多层引用
> 这多机智啊！ > 这多机智啊！
```
<!-- 序列 --> ## 列表
<!-- 无序序列可由星号，加号或者减号来建立 --> 无序列表可由星号，加号或者减号来创建
```md
* 项目 * 项目
* 项目 * 项目
* 另一个项目 * 另一个项目
@@ -102,139 +133,198 @@ __此文本也是__
- 项目 - 项目
- 最后一个项目 - 最后一个项目
<!-- 有序序列可由数字加点来实现 --> ```
有序序列可由数字加上点 `.` 来实现
```md
1. 项目一 1. 项目一
2. 项目二 2. 项目二
3. 项目三 3. 项目三
```
<!-- 即使你的标签数字有误，Markdown 依旧会呈现出正确的序号， 即使你的标签数字有误，Markdown 依旧会呈现出正确的序号，
不过这并不是一个好主意--> 不过这并不是一个好主意
```md
1. 项目一 1. 项目一
1. 项目二 1. 项目二
1. 项目三 1. 项目三
<!-- (此段与前例一模一样) --> ```
(此段与上面一模一样)
<!-- 你也可以使用子序列 --> 你也可以使用子列表
```md
1. 项目一 1. 项目一
2. 项目二 2. 项目二
3. 项目三 3. 项目三
* 子项目 * 子项目
* 子项目 * 子项目
4. 项目四 4. 项目四
```
<!-- 代码段落 --> 你甚至可以使用任务列表，它将会生成 HTML 的选择框（checkboxes）标签。
<!-- 代码段落（HTML中 <code>标签）可以由缩进四格（spaces）
或者一个制表符（tab）实现-->
```md
下面方框里包含 'x' 的列表，将会生成选中效果的选择框。
- [ ] 任务一需要完成
- [ ] 任务二需要完成
下面这个选择框将会是选中状态
- [x] 这个任务已经完成
```
## 代码块
代码块（HTML中 <code>标签）可以由缩进四格（spaces）
或者一个制表符（tab）实现
```md
This is code This is code
So is this So is this
```
<!-- 在你的代码中，你仍然使用tab可以进行缩进操作 --> 在你的代码中，你仍然使用tab（或者四个空格）可以进行缩进操作
```md
my_array.each do |item| my_array.each do |item|
puts item puts item
end end
```
<!-- 内联代码可由反引号 ` 实现 --> 内联代码可由反引号 ` 实现
```md
John 甚至不知道 `go_to()` 方程是干嘛的! John 甚至不知道 `go_to()` 方程是干嘛的!
```
<!-- 在GitHub的 Markdown中，对于代码你可以使用特殊的语法 --> 在GitHub的 Markdown（GitHub Flavored Markdown）解析器中，你可以使用特殊的语法表示代码块
\`\`\`ruby <!-- 插入时记得移除反斜线， 仅留```ruby ！ --> <pre>
<code class="highlight">&#x60;&#x60;&#x60;ruby
def foobar def foobar
puts "Hello world!" puts "Hello world!"
end end
\`\`\` <!-- 这里也是，移除反斜线，仅留 ``` --> &#x60;&#x60;&#x60;</code></pre>
<!-- 以上代码不需要缩进，而且 GitHub 会根据```后表明的语言来进行语法高亮 --> 以上代码不需要缩进，而且 GitHub 会根据\`\`\`后指定的语言来进行语法高亮显示
<!-- 水平线 （<hr />） --> ## 水平线分隔
<!-- 水平线可由三个或以上的星号或者减号创建，可带可不带空格。 -->
Horizontal rules (`<hr/>`) are easily added with three or more asterisks or
hyphens, with or without spaces.
水平线可由三个或以上的星号或是减号创建，它们之间可以带或不带空格
```md
*** ***
--- ---
- - - - - -
**************** ****************
```
<!-- 链接 --> ## 链接
<!-- Markdown 最棒的地方就是简易的链接制作。链接文字放在中括号[]内，
在随后的括弧()内加入url。-->
Markdown 最棒的地方就是便捷的书写链接。把链接文字放在中括号[]内，
在随后的括弧()内加入url就可以了。
```md
[点我点我!](http://test.com/) [点我点我!](http://test.com/)
<!-- 你也可以为链接加入一个标题：在括弧内使用引号 --> ```
You can also add a link title using quotes inside the parentheses.
你也可以为链接加入一个标题：在括弧号内使用引号
你也可以在小括号内使用引号，为链接加上一个标题（title）
```md
[点我点我!](http://test.com/ "连接到Test.com") [点我点我!](http://test.com/ "连接到Test.com")
```
相对路径也可以有
<!-- 相对路径也可以有 --> ```md
[去 music](/music/). [去 music](/music/).
```
<!-- Markdown同样支持引用样式的链接 --> Markdown同样支持引用形式的链接
[点此链接][link1]以获取更多信息！ <pre><code class="highlight">&#x5b;<span class="nv">点此链接</span>][<span class="ss">link1</span>] 以获取更多信息！
[看一看这个链接][foobar] 如果你愿意的话. &#x5b;<span class="nv">看一看这个链接</span>][<span class="ss">foobar</span>] 如果你愿意的话。
[link1]: http://test.com/ "Cool!" &#x5b;<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Cool!"</span>
[foobar]: http://foobar.biz/ "Alright!" &#x5b;<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Alright!"</span></code></pre>
<!-- 链接的标题可以处于单引号中，括弧中或是被忽略。引用名可以在文档的任意何处， 对于引用形式，链接的标题可以处于单引号中，括弧中或是忽略。引用名可以在文档的任意何处，
并且可以随意命名，只要名称不重复。--> 并且可以随意命名，只要名称不重复。
<!-- “隐含式命名” 的功能可以让链接文字作为引用名 --> “隐含式命名” 的功能可以让链接文字作为引用名
[This][] is a link. <pre><code class="highlight">&#x5b;<span class="nv">This</span>][] is a link.
[this]: http://thisisalink.com/ &#x5b;<span class="nv">this</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
<!-- 但这并不常用 --> 但这并不常用
<!-- 图像 --> ## 图片
<!-- 图像与链接相似，只需在前添加一个感叹号 --> 图片与链接相似，只需在前添加一个感叹号
![这是我图像的悬停文本(alt text)](http://imgur.com/myimage.jpg "可选命名") ```md
![这是我图片的悬停文本(alt text)](http://imgur.com/myimage.jpg "可选命名")
```
<!-- 引用样式也同样起作用 --> 引用形式也同样起作用
![这是我的悬停文本.][myimage] <pre><code class="highlight">!&#x5b;<span class="nv">这是我的悬停文本.</span>][<span class="ss">myimage</span>]
[myimage]: relative/urls/cool/image.jpg "在此输入标题" &#x5b;<span class="nv">myimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"在此输入标题"</span></code></pre>
<!-- 杂项 --> ## 杂项
<!-- 自动链接 --> ### 自动链接
```md
<http://testwebsite.com/> 与 <http://testwebsite.com/> 与
[http://testwebsite.com/](http://testwebsite.com/) 等同 [http://testwebsite.com/](http://testwebsite.com/) 等同
```
<!-- 电子邮件的自动链接 --> ### 电子邮件的自动链接
```md
<foo@bar.com> <foo@bar.com>
```
<!-- 转义字符 --> ### 转义字符
```md
我希望 *将这段文字置于星号之间* 但是我不希望它被 我希望 *将这段文字置于星号之间* 但是我不希望它被
斜体化, 所以我就: \*这段置文字于星号之间\*。 斜体化, 这么做: \*这段置文字于星号之间\*。
```
<!-- 表格 --> ### 键盘上的功能键
<!-- 表格只被 GitHub 的 Markdown 支持，并且有一点笨重，但如果你真的要用的话: -->
In GitHub Flavored Markdown, you can use a `<kbd>` tag to represent keyboard
keys.
在 GitHub 的 Markdown中，你可以使用 `<kbd>` 标签来表示功能键。
```md
你的电脑死机了？试试
<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 的摘要笔记。 更多信息, 请于[此处](http://daringfireball.net/projects/Markdown/syntax)参见 John Gruber 关于语法的官方帖子，及于[此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet) 参见 Adam Pritchard 的摘要笔记。