Markdown基础语法(上)
前言
按照官方文档，和根据自己所用和所理解所写
一.标题语法
一级标题最大，六级标题最小
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
二.段落语法
一个回车一个段落
我是真的喜欢你
不，你是个好人。
三.换行语法
在一行的末尾添加两个或者多个空格然后回车就可以创建一个换行
官方说的是还是直接回车键实现换行。我在换行的地方输入了 br
可以对比段落语法和换行语法一行的间距区别，还是很明显的。
这是第一行
这是第二行
四.强调语法
如果要加粗文本在单词或者短语前后加上
加上两个**即可，或者两个下划线
正常字体
1.粗体
加粗
但是我的建议是使用**来实现加粗
渲染代码如下
**加粗**
**加粗**
第二种语法在长句无效
2.倾斜
倾斜
渲染代码如下
_倾斜_
3.斜体加粗
斜体加粗
渲染代码如下
**_斜体加粗_**
五.引用语法
1.单个引用
如果要创建引用在段落前面加上”>”
I really like you
> I really like you
2.多个引用
Do you like rain?
yes
渲染代码如下
> Do you like rain
>
> yes
3.多层引用
一二三四五
六七八九十
十一十二十三
十四十五
十六十七
十八十九
渲染代码如下
> 一二三四五
>
> > 六七八九十
> >
> > > 十一十二十三
> > >
> > > > 十四十五
> > > >
> > > > > 十六十七
> > > > >
> > > > > > 十八十九
4.带有其他元素的块引用
四级标题
测试 1
测试 2
测试 测试 测试
渲染代码如下
> 四级标题
>
> - 测试 1
> - 测试 2
>
> _测试_ 测试 **测试**
六.列表语法
1.有序列表
需要注意的是“.”的后面有一个空格
- 第一个
- 第二个
- 第三个
- 第四个
渲染代码如下
1. 第一个
2. 第二个
3. 第三个
4. 第四个
- 第一个
- 第二个
- 第三个
- 第三点一个
- 第三点二个
- 第四个
渲染代码如下
1. 第一个
2. 第二个
3. 第三个
1. 第三点一个
2. 第三点二个
4. 第四个
2.无序列表
和上面的有序列表差不多都有空格
- 第一个
- 第二个
- 第三个
- 第四个
渲染代码如下
- 第一个
- 第二个
- 第三个
- 第四个
另外一种方法，一样的效果
- 第一个
- 第二个
- 第三个
- 第四个
渲染代码如下
* 第一个
* 第二个
* 第三个
* 第四个
层级
- 第一个
- 第二个
- 第三个
- 第一个
- 第二个
- 第三个
- 第四个
渲染代码如下
- 第一个
- 第二个
- 第三个
- 第一个
- 第二个
- 第三个
- 第四个
3.在列表中套用其他元素
3.1段落
-
第一个
-
第二个
我是第三个
-
第四个
渲染代码如下
- 第一个
- 第二个
我是第三个
- 第四个
3.2引用
-
第一个
-
第二个
我是第三个
-
第四个
渲染代码如下
- 第一个
- 第二个
> 我是第三个
- 第四个
3.3代码块
-
第一个
-
第二个
测试 -
第三个
渲染代码如下
1. 第一个
2. 第二个
<html>
<head>
<title>测试</title>
</head>
</html>
3. 第三个
3.4列表
- 第一个
- 第二个
- 第一个
- 第二个
- 第三个
渲染代码如下
1. 第一个
2. 第二个
- 第一个
- 第二个
3. 第三个
七.代码语法
如果要把单词或者短语表示为代码就用`包裹代码
print是 python 的输出语句
渲染代码如下
`print`是 python 的输出语句
1.转义符
如果需要展现出`符号，请在单词或者短语用“包裹
Markdown代码表示单词语法是`print`是对的
渲染代码如下
`` Markdown代码表示单词语法是`print`是对的 ``
八.分割线语法
如果要使用分割线，在单独一行使用三个或者多个***或者—或者___
并且不能包含其他内容
渲染代码如下
---
---
---
为了兼容性在分割线前后加上空白行
九.链接语法
这是一个链接Ken 的博客
渲染代码如下
这是一个链接[Ken 的博客](//blog.takagisan.top)
1.给链接增加 title
这是一个链接Ken 的博客
渲染代码如下
这是一个链接[Ken 的博客](//blog.takagisan.top "Ken的博客")
2.网址和 email 地址
使用尖括号即可方便把 URL 或者 email 地址变成可点击的链接。
渲染代码如下
<//blog.takagisan.top>
<[email protected]>
3.带格式化的链接
这是我的博客
这是我的博客
This is code
渲染代码如下
这是我的**[博客](//blog.takagisan.top "Ken的博客")**
这是我的*[博客](//blog.takagisan.top "Ken的博客")*
This is [`code`](#code)
4.引用类型链接
尽量如下样式
[1]: //en.wikipedia.org/wiki/Hobbit#Lifestyle
渲染代码如下
- `[1]: //en.wikipedia.org/wiki/Hobbit#Lifestyle`
十.图片语法
要使用图像使用!在方括号里添加替代文本在与圆括号放图片链接
渲染代码如下
1.链接图片
和上面的区别是，使用了另外一个方括号把上面的内容括起来，然后使用了另外一个圆括号
渲染代码如下
[](//blog.takagisan.top)
十一.转义字符语法
要使原本用来格式化 Markdown 的字符在，前面添加反斜杠,\即可
*我好帅*
渲染代码如下
\*我好帅\*
1.可做转义的字符
根据官方文档，如下图,下图都可以通过反斜杠来转义
2.特殊字符自动转义
如下是官方文档原文
在 HTML 文件中，有两个字符需要特殊处理： < 和 & 。 < 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要使用这些符号，你必须要使用实体的形式，像是 < 和 &。
& 符号其实很容易让写作网页文件的人感到困扰，如果你要打「AT&T」 ，你必须要写成「AT&T」 ，还得转换网址内的 & 符号，如果你要链接到：
//images.google.com/images?num=30&q=larry+bird
你必须要把网址转成：
//images.google.com/images?num=30&q=larry+bird
才能放到链接标签的 href 属性里。不用说也知道这很容易忘记，这也可能是 HTML 标准检查所检查到的错误中，数量最多的。
Markdown 允许你直接使用这些符号，它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分，那么它不会被转换，而在其它情况下，它则会被转换成 &。所以你如果要在文件中插入一个著作权的符号，你可以这样写：
©
Markdown 将不会对这段文字做修改，但是如果你这样写：
AT&T
Markdown 就会将它转为：
AT&T
类似的状况也会发生在 < 符号上，因为 Markdown 支持行内 html，如果你使用 < 符号作为 HTML 标签的分隔符，那 Markdown 也不会对它做任何转换，但是如果你是写：
4 < 5
Markdown 将会把它转换为：
4 < 5
需要特别注意的是，在 Markdown 的块级元素和内联元素中， < 和 & 两个符号都会被自动转换成 HTML 实体，这项特性让你可以很容易地用 Markdown 写 HTML。（在 HTML 语法中，你要手动把所有的 < 和 & 都转换为 HTML 实体。）
十二.内嵌 HTML 标签
如下是官方文档原文
HTML 的行级內联标签如 <span>、<cite>、<del> 不受限制，可以在 Markdown 的段落、列表或是标题里任意使用。依照个人习惯，甚至可以不用 Markdown 格式，而采用 HTML 标签来格式化。例如：如果比较喜欢 HTML 的 <a> 或 <img> 标签，可以直接使用这些标签，而不用 Markdown 提供的链接或是图片语法。当你需要更改元素的属性时（例如为文本指定颜色或更改图像的宽度），使用 HTML 标签更方便些。
HTML 行级內联标签和区块标签不同，在內联标签的范围内， Markdown 的语法是可以解析的。
This **word** is bold. This <em>word</em> is italic.
渲染效果如下:
This word is bold. This word is italic.
1.区块标签
区块元素 ── 比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行，以便于内容区分。而且这些元素的开始与结尾标签，不可以用 tab 或是空白来缩进。Markdown 会自动识别这区块元素，避免在区块标签前后加上没有必要的 <p> 标签。
例如，在 Markdown 文件里加上一段 HTML 表格：
This is a regular paragraph.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
This is another regular paragraph.
请注意，Markdown 语法在 HTML 区块标签中将不会被进行处理。例如，你无法在 HTML 区块内使用 Markdown 形式的*强调*。
2.Html 用法最佳实践
出于安全原因，并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问，请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。
对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>，请在其前后使用空行（blank lines）与其它内容进行分隔。尽量不要使用制表符（tabs）或空格（spaces）对 HTML 标签做缩进，否则将影响格式。
在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。
