Markdown语法基础

Posted 2020-08-11 万丈高楼平地起

Markdown基本语法

创建 2018-09-07 by YANHAI

标题：Setext方式

三个或更多

大标题
===
小标题
---

大标题

小标题

标题：Atx方式

# 内容 （一级标题）
## 内容 （二级标题）
### 内容 （三级标题）
#### 内容 （四级标题）
##### 内容 （五级标题）
###### 内容 （六级标题）

内容 （一级标题）

内容 （二级标题）

内容 （三级标题）

内容 （四级标题）

内容 （五级标题）

内容 （六级标题）

无序列表

符号之后的空格不能少，-+*效果一样，但不能混合使用，因混合是嵌套列表，内容可超长

- 无序列表
- 无序列表
- 无序列表
- 无序列表：我很长。我也很长！那比一比啊

• 无序列表
• 无序列表
• 无序列表
• 无序列表：我很长。我也很长！那比一比啊

符号之后的空格不能少，-+*效果一样，但不能混合使用，因混合是嵌套列表

* 无序列表
* 无序列表
* 无序列表
* 无序列表：我很长。我也很长！那比一比啊

• 无序列表
• 无序列表
• 无序列表
• 无序列表：我很长。我也很长！那比一比啊

有序列表

数字不能省略但可无序，点号之后的空格不能少

1. 有序列表
2. 有序列表
5. 有序列表
3. 有序列表

1. 有序列表
2. 有序列表
3. 有序列表
4. 有序列表

嵌套列表

-+*可循环使用，但符号之后的空格不能少，符号之前的空格也不能少
符号之前的空格个数必须为2的倍数

- 嵌套列表1
    + 嵌套列表2
    + 嵌套列表3
        - 嵌套列表4
            * 嵌套列表5
- 嵌套列表6

• 嵌套列表1
  • 嵌套列表2
  • 嵌套列表3
    • 嵌套列表4
      • 嵌套列表5
• 嵌套列表6

文字超链接：Inline方式

[百度首页](https://www.baidu.com)

百度首页

索引超链：Reference方式

索引，百度首页可以是任意字符
就相当于先定义一个索引表示一个链接，后面用这个链接的时候写这个索引即可
这样的好处是，以后要改这个链接，只改一个地方就可以了

[百度首页]:https://www.baidu.com
[百度][百度首页]  
其他内容  
[这也是百度][百度首页]  

百度
其他内容
这也是百度

使用图片

插图最基础的格式就是：
![Alt text](图片链接 "optional title")

Alt text：图片的Alt标签，用来描述图片的关键词，可以不写。最初的本意是当图片因为某种原因不能被显示时而出现的替代文字，后来又被用于SEO，可以方便搜索引擎根据Alt text里面的关键词搜索到图片。 图片链接：可以是图片的本地地址或者是网址。"optional title"：鼠标悬置于图片上会出现的标题文字，可以不写。

本地图片

![本地图片](picture.jpg "猪猪")

网络图片 超链接

![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")

自动链接

尖括号

<https://www.baidu.com>  
<https://www.qq.com/>

https://www.baidu.com
https://www.qq.com/

引用

>引用

引用

内层符号前的空格必须要

>引用
 >>引用中的引用

引用

引用中的引用

粗体 斜体

星号与下划线都可以，单是斜体，双是粗体，符号可跨行，符号可加空格

**一个人来到田纳西**
__毫无疑问__

*我做的馅饼  
是全天下*

_最好吃的_

一个人来到田纳西
毫无疑问

我做的馅饼
是全天下

最好吃的

删除线

~~这是删除线~~

这是删除线

换行、分段

换行：行末加两个或以上个空格
分段：两个回车

分割线

三个或更多-_*，必须单独一行，可含空格

---
***
___

---

---

---

行对齐

语法:
<div align="value">

属性值:

值	描述
left	左对齐内容。
right	右对齐内容。
center	居中对齐内容。
justify	对行进行伸展，这样每行都可以有相等的长度（就像在报纸和杂志中）。

html参考

居中

居中使用html添加：

<center>这一行需要居中</center>

这一行需要居中

也可以:

<div align="center">这一行也可以居中</div>

这一行也可以居中

右对齐

第1种方法:

<div align="right">这一行靠右对齐</div>

这一行靠右对齐

第2种方法:

<right>这一行不会右对齐</right>

这一行不会右对齐

段首缩进

将输入法切换到全角模式，方法是在中文输入法下，按shift+space键切换，然后直接输入空格就可以了，这样输入的每个空格是一个中文字符距离。

　　生命里，一些缱绻，无论素净，还是喧哗，都已经被岁月赋予了清喜的味道，一些闲词，或清新，或淡雅，总会在某一个回眸的时刻醉了流年，濡湿了柔软的心，冥冥之中，我们沿着呼唤的风声，终于在堆满落花的秋里，再次重逢，念在天涯，心在咫尺，我相信，一米阳光，才是我们最好的距离。

　　生命里，一些缱绻，无论素净，还是喧哗，都已经被岁月赋予了清喜的味道，一些闲词，或清新，或淡雅，总会在某一个回眸的时刻醉了流年，濡湿了柔软的心，冥冥之中，我们沿着呼唤的风声，终于在堆满落花的秋里，再次重逢，念在天涯，心在咫尺，我相信，一米阳光，才是我们最好的距离。

段落缩进（空格）

半方大的空白 或 看，飞碟  
全方大的空白 或 看，飞碟  
不断行的空白格 或 看，飞碟  
  段落从此开始。

半方大的空白?或?看，飞碟
全方大的空白?或?看，飞碟
不断行的空白格?或?看，飞碟
??段落从此开始。

字体、字号、颜色

<font face="黑体">我是黑体字</font>  
<font face="微软雅黑">我是微软雅黑</font>  
<font face="STCAIYUN">我是华文彩云</font>  
<font color=#0099ff size=12 face="黑体">黑体</font>  
<font color=#00ffff size=3>null</font>  
<font color=gray size=5>gray</font>

我是黑体字
我是微软雅黑
我是华文彩云
黑体
null
gray

代码：行内代码

在第一行后指定编程语言，也可以不指定

    ``` python
    @requires_authorization
    def somefunc(param1='', param2=0):
        '''A docstring'''
        if param1 > param2: # interesting
            print 'Greater'
        return (param2 - param1 + 1) or None
    class SomeClass:
        pass
    >>> message = '''interpreter
    ... prompt'''
    ```

可代码高亮

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

代码：段落代码

每行文字前加4个空格或者1个Tab

    val s = "hello Markdown"
    println( s )
    val s = "hello Markdown"
    println( s )

val s = "hello Markdown"
println( s )
val s = "hello Markdown"
println( s )

注释

用html的注释，好像只有这样？

<!-- 注释 -->

转义字符

用html的注释，好像只有这样？
Markdown中的转义字符为，转义的有：

\\ 反斜杠  
\` 反引号  
\* 星号  
\_ 下划线  
\{\} 大括号  
\[\] 中括号  
\(\) 小括号  
\# 井号  
\+ 加号  
\- 减号  
\. 英文句号  
\! 感叹号

\ 反斜杠
` 反引号
* 星号
_ 下划线
{} 大括号
[] 中括号
() 小括号
# 井号
+ 加号
- 减号
. 英文句号
! 感叹号

表格

---至少要3个，:---表示左对齐，---:表示右对齐 :---:表示居中

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

或者

项目     | 价格
-------- | ---
Computer | $1600
Phone    | $12
Pipe     | $1

项目	价格
Computer	$1600
Phone	$12
Pipe	$1