diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown index e9a8aeb2..2bd8d11a 100644 --- a/zh-cn/markdown-cn.html.markdown +++ b/zh-cn/markdown-cn.html.markdown @@ -4,45 +4,63 @@ contributors: - ["Dan Turkel", "http://danturkel.com/"] translators: - ["Fangzhou Chen","https://github.com/FZSS"] + - ["Luffy Zhong", "https://github.com/mengzhongshi"] filename: learnmarkdown-cn.md lang: zh-cn --- Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的语法结构,并可以便利地转换成 HTML(以及其他很多)格式。 -欢迎您多多反馈以及分支和请求合并。 +在不同的解析器中,Markdown 的实现方法有所不同。 +此教程会指出哪些特征是通用,哪一些只对某一解析器有效。 +- [HTML标签](#HTML标签) +- [标题](#标题) +- [文本样式](#文本样式) +- [段落](#段落) +- [列表](#列表) +- [代码块](#代码块) +- [水平线分隔](#水平线分隔) +- [链接](#链接) +- [图片](#图片) +- [杂项](#杂项) + +## HTML标签 +Markdown 是 HTML 的父集,所以任何 HTML 文件都是有效的 Markdown。 ```md - +``` - +## 标题 - - +通过在文本前加上不同数量的hash(#), 你可以创建相对应的 `
` 标签)可以由缩进四格(spaces)
+或者一个制表符(tab)实现
+
+```md
This is code
- So is this
+ So is this
+```
-
+在你的代码中,你仍然使用tab(或者四个空格)可以进行缩进操作
+```md
my_array.each do |item|
puts item
end
+```
-
+内联代码可由反引号 ` 实现
+```md
John 甚至不知道 `go_to()` 方程是干嘛的!
+```
-
+在GitHub的 Markdown(GitHub Flavored Markdown)解析器中,你可以使用特殊的语法表示代码块
-\`\`\`ruby
+
+```ruby
def foobar
puts "Hello world!"
end
-\`\`\`
+```
-
+以上代码不需要缩进,而且 GitHub 会根据\`\`\`后指定的语言来进行语法高亮显示
-
-
+## 水平线分隔
+水平线(`
`)可由三个或以上的星号或是减号创建,它们之间可以带或不带空格
+
+```md
***
---
- - -
****************
+```
-
-
+## 链接
+Markdown 最棒的地方就是便捷的书写链接。把链接文字放在中括号[]内,
+在随后的括弧()内加入url就可以了。
+
+```md
[点我点我!](http://test.com/)
-
-
-[点我点我!](http://test.com/ "连接到Test.com")
-
-
-
-[去 music](/music/).
-
-
-
-[点此链接][link1]以获取更多信息!
-[看一看这个链接][foobar] 如果你愿意的话.
-
-[link1]: http://test.com/ "Cool!"
-[foobar]: http://foobar.biz/ "Alright!"
-
-
-
-
-
-[This][] is a link.
-
-[this]: http://thisisalink.com/
-
-
-
-
-
-
-![这是我图像的悬停文本(alt text)](http://imgur.com/myimage.jpg "可选命名")
-
-
-
-![这是我的悬停文本.][myimage]
-
-[myimage]: relative/urls/cool/image.jpg "在此输入标题"
-
-
-
-
- 与
-[http://testwebsite.com/](http://testwebsite.com/) 等同
-
-
-
-
-
-
-
-我希望 *将这段文字置于星号之间* 但是我不希望它被
-斜体化, 所以我就: \*这段置文字于星号之间\*。
-
-
-
-
-| 第一列 | 第二列 | 第三列 |
-| :---------- | :------: | ----------: |
-| 左对齐 | 居个中 | 右对齐 |
-| 某某某 | 某某某 | 某某某 |
-
-
-
-第一列 | 第二列 | 第三列
-:-- | :-: | --:
-这太丑了 | 药不能 | 停
-
-
-
+```
+
+你也可以在小括号内使用引号,为链接加上一个标题(title)
+
+```md
+[点我点我!](http://test.com/ "连接到Test.com")
+```
+相对路径也可以有
+
+```md
+[去 music](/music/).
+```
+
+Markdown同样支持引用形式的链接
+
+```md
+[点此链接][link1] 以获取更多信息!
+[看一看这个链接][foobar] 如果你愿意的话。
+[link1]: http://test.com/
+[foobar]: http://foobar.biz/
+```
+
+对于引用形式,链接的标题可以处于单引号中,括弧中或是忽略。引用名可以在文档的任何地方,并且可以随意命名,只要名称不重复。
+
+“隐含式命名” 的功能可以让链接文字作为引用名
+
+```md
+[This][] is a link.
+[This]: http://thisisalink.com/
+```
+
+但这并不常用
+
+## 图片
+图片与链接相似,只需在前添加一个感叹号
+
+```md
+![这是alt,请把鼠标放在图片上](http://imgur.com/myimage.jpg "这是title")
+```
+
+引用形式也同样起作用
+
+```md
+![这是alt][myimage]
+[myimage]: relative/urls/cool/image.jpg
+```
+
+## 杂项
+### 自动链接
+
+```md
+ 与
+[http://testwebsite.com/](http://testwebsite.com/) 等同
+```
+
+### 电子邮件的自动链接
+
+```md
+
+```
+
+### 转义字符
+
+```md
+我希望 *将这段文字置于星号之间* 但是我不希望它被
+斜体化, 这么做: \*这段置文字于星号之间\*。
+```
+
+### 键盘上的功能键
+
+在 GitHub 的 Markdown中,你可以使用 `` 标签来表示功能键。
+
+```md
+你的电脑死机了?试试
+Ctrl+Alt+Del
+```
+Ctrl+Alt+Del
+### 表格
+
+表格只被 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 的摘要笔记。