Markdown学习
Markdown学习记录v1.0
- 1. 简介:
Markdown: 发明者:JOHN GRUBER.一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。
- 2. 基础语法:
① 标题
第一种方式:# 文字 # 建议前后隔一个空格,后面的#可省
示例:
# h1 #
## h2 ##
### h3
#### h4
##### h5
###### h6
第二种方式: = 或 –(减号) 该标记符独自占一行(标记符数量显示的效果一样),不能有其他内容文本写在下一行,缺点:只有2种文字大小效果
示例:
=
一级标题
=====
一级标题
-
二级标题
----
二级标题
② 段落和换行
段落:普通段落不该用空格或制表符来缩进???????
示例:
段落和换行一个 Markdown 段落是由一个或多个连续的文本行组成，
它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，
便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。
换行:在每行末尾敲两个空格,再按回车
③ 区块引用
格式: > 引用内容 必须空格隔开
示例:
区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ：
> This is the first level of quoting.写法不美观,最好每行写个<
This is the first level of quoting. This is the first level of quoting. This is the first level of quoting. This is the first > > > This is nested blockquote.> > > > Back to the first level. 引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
④ 列表
- 无序列表
标记符:星号(*)或加号(+)或减号(-) 注:标记符与文本内容之间至少间隔一个空格,可以混合使用,建议统一格式 ,排配异常,可多次缩进
示例:
+ 香蕉
+ 苹果
+ 菠萝
- 香蕉
- 菠萝
- 苹果
* 香蕉
* 苹果
* 菠萝
- 有序列表
标记符:数字和英文符号点(.) 注:标记符与文本内容之间至少间隔一个空格,最好排序使用如,1. ,2. 排配异常,可多次缩进
示例:
- 有序列表
- 有序列表
3. This is a list item with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
. . . . . . . . . .
n. 有序列表
3. 注意情况:
3.1 项目列表里放置引用时,该区块就要缩进
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
3.2 项目列表里放置区块代码时,该区块就要缩进2个Tab
⑤ 代码区块
1.内联(单行)代码: 标记符反引号(`)包住代码
示例:
这是一个行内代码 `var x = 2`
2. 块级代码:
方式一: 直接缩进1个Tab
示例:
这是一个代码块`var x = 2;`
方式二: 若在项目列表里,就必须缩进2个Tab
示例:
* 列表下的代码块需要缩进2个tab
int main()
{
printf("我是个段落代码块");
return 0;
}
方式三: 加入至少2个反引号(```),中间放置代码块,也可以添加代码类型注释
示例:
```javascript
var num = 0;
for (var i = 0; i < 5; i++) {
num+=i;
}
console.log(num);
```
⑥ 插入链接和图片
一:链接:
- 行内链接
标记符: [文本内容](链接地址 “title”) 注:[]与()不能有空格, title: 可选,为鼠标悬显示的内容,可以使用双引号号(""),单引号(''),括号()
示例:
这是一个百度链接: [点我百度](http://www.baidu.com "百度一下")
这是一个百度链接:[点我百度](http://www.baidu.com ‘百度一下’)
这是一个百度链接:[点我百度](http://www.baidu.com (百度一下))
2. 参考式链接
2.1: 引用式
标记符1: [文本内容][网址辨识标签]{:target=”属性值”} 注:此处是声明链接,网址辨识标签组成:字母,数字,空白,标点符号,其中字母不区分大小写; {:target=”属性值”}: 可选,代表html里的窗口代开方式,属性值: _blanket, _parent, ……
标记符2: [网址辨识标签]:链接地址 “title”, (如果网址辨识标签为空白,标记符2格式为: [文本内容]: 链接地址 “title”) 注:此处是定义链接
示例:
[点我百度][] {:target="_blank"}
[点我百度]:http://www.baidu.com "百度一下"
[点我百度][1] {:target="_blank"}
[1]:http://www.baidu.com "百度一下"
[点我百度][百度] {:target="_blank"}
[百度]:http://www.baidu.com "百度一下"
[点我百度][a] {:target="_blank"}
[a]:http://www.baidu.com "百度一下"
[A]:http://www.baidu.com "百度一下"
2.2: 自动生成链接
标识符: <URL>
示例:
自动生成连接 <http://www.github.com/>
二: 图片
标识符:  注:和链接类似,就是多个感叹号(!)
示例:
![GitHub set up][01]
[01]:http://zh.mweb.im/asset/img/set-up-git.gif "引用式"
⑦ 强调
1. 斜体
标记符: 单个星号(*)或单个底线(_), 注:标记符前后包住文本,且之间不能有空格
示例:
*斜体1*
_斜体2_
2. 加粗
标记符: 两个星号(*)或两个底线(_) 注: :标记符前后包住文本,且之间不能有空格
示例:
**我是粗体1**
_ _我是粗体2_ _
⑧ 分割线
标计符: 3个以上(含三个)的星号(*)或底线(_)或减号(-), 备注: 标记符独占一行,之间可以用空格隔开,分割线在内容下边, 减号好像只能间隔使用
示例:
星号分隔线***
***
间隔星号分隔线* * *
* * *
底线分隔线__
___
间隔底线分隔线_ _ _
_ _ _ _ _
间隔减号分隔线- - -
- - - -
减号分隔线????不行
-------------------------
对对对
⑨ 删除线
标记符: 2个波浪线(~) ,前后包住文本内容
示例:
~~我是删除线~~
⑩ 表格
标记符: 竖线( | )代表边框, 冒号( :)代表对齐方式, 注: : 与 | 之间不要有空格,会发生格式不兼容
示例:
| head | head | head|
|:------|:------:|-----:|
|左对齐 |居中 | 右对齐|
简写:
head | head | head
:------|:------:|-----:
左对齐 |居中 | 右对齐
⑪ 脚注
标记符1: 文本内容[^id] 注:此为声明脚注,^必须有,id可为数字,字母
标记符2: [^id]: 注: 此为定义脚注的解释内容
示例:
Markdown语法[^a]
[^a]:Markdown是一种纯文本标记语言 //
在文章最后面显示脚注
效果如图:
⑫ 锚点
标记符: [文本内容](#id) 注: 只有标题支持锚点
示例:
[我是锚点](#1)
⑬ 目录
标记符: [TOC] 注: 根据标题生成目录，兼容性一般
⑭ 6
⑮ 6
- 3. 总结：常用标记
|
标记 |
Markdown 语法 |
|
斜体 |
*italic* |
|
粗体 |
**bold** |
|
图片 |
 |
|
链接 |
[Link Text](http://xxx.com) |
|
内联代码 |
`code` |
|
块级代码 |
```code block``` |
|
引用 |
> Here is a quote block |
|
分隔符 |
---- 或 ***** |
|
标题 |
# Heading 1 |
|
列表 |
*或+或- 有序: n. |
|
### Heading 3 |
|
|
标题 4 |
#### Heading 4 |
浙公网安备 33010602011771号