markdown语法笔记(入门)
写在前面的话
关于编辑器
个人有用过MarkdownPad2,马克飞象,Leanote
- MarkdownPad2:识别最标准的Markdown语法,不支持其他拓展语法,比如``` 代码块无法识别
- 马克飞象:黑色界面很好看,刚打开时的示例文档写的很好,学语法也可以参考这个,但是如果支持同步线上需要一丢丢money的
- leanote:是个人现在用的最多的,同步线上只需注册一个账号即可,免费~
关于html
markdown也能识别html语法,甚至可以识别简单的样式
写法:
<div>
<p style="background:red">文字</p>
<span style="color:orange">行内文字</span>
<b>加粗</b>
<i>斜体</i>
</div>
效果:
文字
行内文字 加粗 斜体关于文章内容
个人经验尚浅,本文内容有任何不正确或不严谨的地方请指正
标题
一共六级,对应了html中的h1-h6标签
注意:标记和内容之间要加空格,这是最标准的markdown语法
写法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
其中一、二级标题有简写形式
一级标题写法2
=
二级标题写法2
-
效果:
一级标题写法2
二级标题写法2
注意:该简写语法部分编辑器支持,比如马克飞象不支持
列表
无序列表
写法:
- 这是无序列表项目
一个类目下多条数据只需要在前面加一个tab或4个空格即可
想在不同类目之间换行在上一个的行尾加两个空格
- 这是无序列表项目
- 这是无序列表项目
效果:
- 这是无序列表项目
一个类目下多条数据只需要在前面加一个tab或4个空格即可
想在不同类目之间换行在上一个的行尾加两个空格 - 这是无序列表项目
- 这是无序列表项目
无序也可以用*或者+代替-,要记得后面加空格
注意:两个列表之间不能相邻,否则会解释为嵌套的列表
有序列表
写法:
1. 这是有序列表项目
2. 这是有序列表项目
3. 这是有序列表项目
效果:
- 这是有序列表项目
- 这是有序列表项目
- 这是有序列表项目
注意:有序列表后面跟的是英文的
.
不是中文的、
,点后面也要加空格
嵌套的列表
写法:
- 外层列表项目
- 内层列表项目
- 内层无序列表项目
- 内层列表项目
- 外层列表项目
效果:
- 外层列表项目
- 内层列表项目
- 内层无序列表项目
- 内层列表项目
- 外层列表项目
引用
写法:
> 这几个文字是引用
效果:
这几个文字是引用
分割线
写法:
这是一条分割线
***
效果:
这是一条分割线
插入链接和图片
写法:
链接:
- 写法1:直接地址链接 https://www.baidu.com/
- 写法2:带链接文字的 [Baidu](http://baidu.com)
- 写法3:带提示文字的 [Baidu](http://baidu.com "百度")
图片:
- 写法1:引用线上图片或服务器图片 ![Baidu logo](https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png) ,[]中的内容相当于alt属性的值
- 写法2:引用本地图片,一般编辑器都带有快捷键功能可直接引用,自己写可写为:![](文件的绝对路径)
- 写法3:带提示文字的 ![Baidu logo](https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png "示例图片")
参考形式的链接(也叫索引形式链接),可以以索引方式把url都列在文章的最后:
>索引名称可以用字母、数字和空格,但是不分大小写
[Baidu][1]
![Baidu logo][2]
[1]:https://www.baidu.com/
[2]:https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png
效果:
链接:
- 写法1:直接地址链接 https://www.baidu.com/
- 写法2:带链接文字的 Baidu
- 写法3:带提示文字的 Baidu
图片:
- 写法1:引用线上图片或服务器图片 ,[]中的内容相当于alt属性的值
- 写法3:带提示文字的
参考形式的链接(也叫索引形式链接),可以以索引方式把url都列在文章的最后:
索引名称可以用字母、数字和空格,但是不分大小写
插入图片的地址需要图床,推荐CloudApp的服务,生成URL地址即可
粗体和斜体
写法:
**这是粗体1**
__这是粗体2__
*这是斜体1*
_这是斜体2_
效果:
这是粗体1
这是粗体2
这是斜体1
这是斜体2
注意:标记和内容之间不需要空格
代码框
单行代码框
写法:
`code code code`
效果:
code code code
多行代码框1
行的开头空4个空格,表示程序代码:在正文显示中会自动识别语言,进行代码染色
Javascript:
/**
* nth element in the fibonacci series.
* @param n >= 0
* @return the nth element, >= 0.
*/
function fib(n) {
var a = 1, b = 1;
var tmp;
while (--n >= 0) {
tmp = a;
a += b;
b = tmp;
}
return a;
}
document.write(fib(10));
多行代码框2
代码块开头和结尾分别加上```标记,开头的标记后面还可以跟上语言类型
code1
code1-1
code2
code2-1
code2-2
换行问题
单个回车:空格/段内换行(不同编辑器下表现不同)
两个回车:换行(另起一段)
结束文字后两个空格+单个回车:段内换行(单纯折行)
单个回车
文字
文字
两个或多个回车(另起一段)
文字
文字
文字后两个空格+单个回车
文字
文字