自学markdown

markdown简介

什么是markdown

markdown是一种简单的标记语言，可以被编译成HTML界面，也可以单独以纯文本形式显示。

• markdown目标是”易读易写”
• 兼容HTML

markdown基本语法

1.markdown标题

• 使用 = 和 – 标记一级和二级标题

我展示的是一级标题
================
我展示的是二级标题
----------------

我展示的是一级标题

我展示的是二级标题

• 使用#号标记

# 一级标题
### 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2.markdown段落格式

段落

• markdown没有特殊的格式，直接编写文字就好
• 段落的换行是使用两个以上空格加上回车

字体

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

分隔线

• 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线

****
* * *
******
- - -
----------

删除线

• 如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可

Venns  
~~Venns~~

Venns
Venns

下划线

• 下划线可以通过 HTML 的<u> 标签来实现

<u>带下划线文本</u>

带下划线文本

脚注

• 脚注是对文本的补充说明

[^要注明的文本]

实例演示:

创建脚注格式类似这样[^Venns]
[^Venns]:hello world

3.markdown列表

• Markdown 支持有序列表和无序列表。
• 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记：

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

效果演示:

• 第一项
• 第二项
• 第三项

• 第一项
• 第二项
• 第三项

• 第一项
• 第二项
• 第三项

列表嵌套

• 列表嵌套只需在子列表中的选项添加四个空格即可

1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

效果演示:

1. 第一项：
   • 第一项嵌套的第一个元素
   • 第一项嵌套的第二个元素
2. 第二项：
   • 第二项嵌套的第一个元素
   • 第二项嵌套的第二个元素

4.markdown区块

• markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号

> 区块引用
> Venns

实现效果:

区块引用
Venns

另外区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推

> 第一层
>> 第二层
>>> 第三层

实现效果:

第一层

第二层

第三层

区块中使用列表

> 区块中使用列表
> 1.第一项
> 2.第二项
> 3.第三项
> + 第一项
> + 第二项
> + 第三项

实现效果:

区块中使用列表
1.第一项
2.第二项
3.第三项

• 第一项
• 第二项
• 第三项

列表中使用区块

+ 第一项
    > 第一层
    > 第二层
+ 第二项

实现效果:

• 第一项
  

  第一层
  第二层

• 第二项

6.markdown代码

• 如果是段落上的一个函数或片段的代码可以用反引号(`)把它包起来 “`

`printf()`函数

实现效果:
printf()函数

代码区块

• 代码区块使用 4个空格或者一个制表符（Tab 键）

    ```可以在这里指定语言
        在这里存放代码
    ````

7.markdown链接

• markdown链接使用方法如下

[链接名称](链接地址)
或者
<链接地址>

例如:

这是一个链接[hello world](www.baidu.com)

实现效果:
这是一个链接hello world

直接使用链接地址:

<www.baidu.com>

实现效果:
www.baidu.com

高级链接

• 我们可以通过变量来设置一个链接，变量赋值在文档末尾进行

这个链接用Venns作为网址变量[baidu][Venns]
[Venns]:www.baidu.com

实现效果:
这个链接用Venns作为网址变baidu

markdown图片

markdown 图片语法格式如下：

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

markdown表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行

|表头|表头|
|----|----|
|单元格|单元格|
|单元格|单元格|

• 对齐方式
  • -:右对齐
  • :-左对齐
  • :-:居中对齐

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

实现效果：

markdown拓展

支持HTML元素

• 不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写，如<b>,<i>,<em>等

<b>he</b><i>llo</i>,<br>world.

实现效果:
hello,
world.

转义字符

• 与其他编程语言转义字符雷同

**文本加粗**
\*\*正常显示星号\*\*

实现效果:
文本加粗
**正常显示星号**

markdown支持以下字符

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

公式

• 当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。

总结

• markdown在现在及以后引用的越来越广泛，有必要熟练，但它也只是一种标记语言，会用就行，不必过于深究。