2017.5.15 markdown简明教程
0.说明
markdown是一种书写格式,html是一种发布格式。markdown的语法种类只对应html标记的一小部分(只涵盖纯文本)。
不在markdown涵盖范围的标签,都可以直接在文档里用html书写,不需要格外标注。
一些格式html区块元素:<div> <table> <pre> <p>等,必须在前面加上空行与其他内容隔开,并且开始和结束时不能用空格来缩进。
更详细的教程地址:http://www.appinn.com/markdown/index.html
1.标题
1 语法:#+空格+标题文本 2 参数:增加一个#,标题增加一级(字号变小),总共有1-6级 3 示例: 4 # 一级标题 5 ## 二级标题
2.强调
2.1 粗体
注意,这里没有空格。
1 语法:**+粗体文本+**
2.2 斜体
注意,这里没有空格。
1 语法:*+斜体文本+*
2.3 分割线
1 语法:单独一行输入***或者---
3.引用
1 语法:>+空格+引用文本
4.列表
4.1 有序列表
1 语法:数字+英文句号+空格+有序列表文本 2 实例:1. 我是文本
4.2 无序列表
1 语法:符号(*,+,-)+空格+无序列表文本 2 示例:* 我是文本 3 - 我是文本 4 + 我是文本
5.链接
5.1 行内
1 语法:[行内链接显示名](行内链接url地址) 2 实例:[这是一个连接](http://baidu.com)
5.2 参考
1 作用:在此处为链接定一个名称,之后在文件的其他地方定义该链接的内容 2 语法:这是参考链接1[参考链接显示名][参考链接id] 3 示例:这是链接1[Google][1] 4 [1]: http://google.com/
5.3 html标签
markdown支持html语法,所以可以使用html的<a>标签。
1 语法:<a href="html标签链接url地址"> 2 示例:<a href="http://baidu.com">链接名</a>
6.图片
6.1 行内
1 语法:![行内图片文本](行内图片地址 "title") 2 示例:![代替文本](/path/to/img.jpg "title")
6.2 参考
1 作用:在文件其他地方定义该图片 2 语法:![参考图片文本][参考图片id] 3 示例:![代替文本][1] 4 [1]: /path/to/img.jpg "title"
6.3 html标签
markdown支持html语法,所以可以使用html的<img>标签。这样比较方便,因为可以直接调整大小。
1 语法:<img src="html标签图片地址" title="标题" width="200px" height="200px“> 2 示例:<img src=" /path/to/img.jpg" width="100px">
7.代码
内部的&,<>都会被自动转换成html实体。
7.1 代码区段
1 语法:`代码区段` 2 反引号:英文输入法下1的左边
7.2 代码区块
每行都缩进一个tab(内部的区块已经是格式化)。
8.反斜杠
1 作用:用于插入一些在语法中有其他意义的符号 2 语法:\+在语法中有其他意义的符号 3 示例:\*这是有意义的符号\* 4 效果:*这是有意义的符号*
9.汇总
语法汇总:
1 #+空格+标题文本 2 **+粗体文本+** 3 *+斜体文本+* 4 ***或者--- 5 >+空格+引用文本 6 7 数字+英文句号+空格+有序列表文本 8 符号(*,+,-)+空格+无序列表文本 9 10 [行内链接显示名](行内链接url地址) 11 这是参考链接1[参考链接显示名][参考链接id] 12 [1]: http://google.com/ 13 <a href="html标签链接url地址"> 14 15 ![行内图片文本](行内图片地址 "title") 16 ![参考图片文本][参考图片id] 17 <img src="html标签图片地址" title="标题" width="200px" height="200px“> 18 19 `代码区段` 20 <div> 21 <label /> 22 </div> 23 24 \+在语法中有其他意义的符号 25
效果显示:
注意:代码区块前后一定要空行!
fighting for this