小组需要使用Markdown来记录,所以整理了一个简明教程给大家浏览~
1. 标题
语法:# + 空格 + 标题文字
标题分为1-6级,增加一个"#"号,标题增加一级,示例如下:
2.强调
l 粗体
语法:** + 文本 + **
l 斜体
语法:* + 文本 + *
l 分割线
语法:***(单独一行输入三个星号)或者---(单独一行输入三个减号)
效果如下:
(注意:星号与文本之间无空格)
3. 引用
语法:> + 空格 +引用文本
效果如下:
4. 列表
l 有序列表
语法:数字+英文句号+空格+文本
(eg:1. 我是文本)
l 无序列表
语法:符号+空格+文本
(此处符号可以是星号、加号和减号)
效果如下:
5. 链接
l 行内
语法:[显示的链接名](链接url地址)
eg: 这是一个[链接](http://baidu.com)
l 参考
语法:[显示的链接名](链接id)
为链接定一个名称,之后在文件的其他地方定义该链接的内容
eg:这是链接1 [Google][1] ,这是链接2[Yahoo][2] .
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
l html标签
由于markdown支持html语法,所以也可以用html的<a>标签
语法:<a href=“链接url地址”>
eg:<a href="http://baidu.com">链接名</a>
效果如下:
6. 图片
l 行内
语法:
eg: 
l 参考
语法:,在文件的其他地方定义该图片id的路径
eg: ![代替文本][id]
[id]: /path/to/img.jpg "Title"
l html标签
由于markdown支持html语法,所以也可以用html的<img>标签,个人认为相对方 便,可以直接调整大小
语法:<img src=“图片地址路径” title="标题" width="200px" height="200px“>
eg:<img src=" /path/to/img.jpg" width="100px">
效果如下:
7. 代码
l 代码区段
语法:反引号 ` 标记代码区段
区段内的 &、< 和 > 都会被自动的转换成 HTML 实体
l 代码区块
语法:每行都缩进 4 个空格或是一个 tab
如果要建立一个已经格式化好的代码区块,只要每行都缩进 4 个空格或是一个 tab 就可以了,而 &、< 和 > 也一样会自动转成 HTML 实体。
效果如下:
8.反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
语法: + 在语法中有意义的符号
注:
1.markdown语法兼容 HTML
Markdown 语法的目标是:成为一种适用于网络的书写语言,它的语法种类只对应 HTML 标记的一小部分(只涵盖纯文本)。HTML 是一种发布的格式,Markdown 是一种书写的格式。
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。
要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
2.本文档提供常用语法使用,推荐一个详细教程:http://www.appinn.com/markdown/index.html