Markdown使用指北

Markdown简介

Markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。Markdown具有轻量化、易读易写的特性，并且支持图片，图表、数学式。目前许多网站广泛使用Markdown来撰写帮助文档或用于论坛上发表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等，甚至还能被使用来撰写电子书。

Markdown由创始人约翰·格鲁伯（John Gruber）于2004年创建，其后经历了多次标准化和功能扩展。

Markdown软件推荐

windows环境推荐软件

Typora、visual studio code、马克飞象、有道云笔记

MacOS 推荐软件

Typora、Ulysses、mou

Linux 推荐软件

Typora、visual studio code、Atom、GNU Emacs、Remarkable、Haroopad、vnote

chorme 推荐插件

Markdown Preview、Markdown Here

Android 推荐软件

joplin、Draft、JotterPad X

iOS 推荐软件

Byword、simplenote

Markdown基本语法

标题

markdown的标题有两种格式

1. 使用=和-，分别标记一级和二级标题。

效果如下：

这是一级标题

这是二级标题

文本如下：

        这是一级标题
=
这是二级标题
-

    

2. 使用#来标记标题。

注意 # 和标题文本之间应有空格(其他标记符也是如此)

效果如下：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

六级标题的字比正文文本的字还小（大雾）

文本如下：

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

    

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成，不同段落之间要有一个以上的空行。

空格

Markdown语法会忽略首行开头的空格，如果要体现出首行开头空两个的效果，可以使用 全角符号下的空格 ，windows下使用 shift+空格 切换。

无序列表

无序列表使用星号（*）、加号（+）或是减号（-）作为列表标记，效果一样。

• 今天

• 明天

• 后天

文本如下：

        + 今天
* 明天
- 后天

    

有序列表

有序列表则使用数字接着一个英文句点(注意是英文句号 是 . 不是 。)。

1. a
2. b
3. c

文本如下：

        + 今天
* 明天
- 后天

    

强调

Markdown 使用星号（*）和底线（_）作为标记强调字词的符号（前后要配对，和文本之间无空隙）。一对星号用于斜体，两对星号用于加粗，三对星号就是两者合体了——斜粗体。底线也是如此。

这是斜体

这是粗体

这是斜粗体

文本如下：

        *这是斜体*

__这是粗体__

***这是斜粗体***

    

分隔线

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

        ***
---
*  *  *

    

效果是这样滴：

删除线

用四个两对波浪线（~）显示删除线：

这是要删除的文本

文本如下：

        ~~这是要删除的文本~~

    

行内代码标记

行内代码标记用反引号把它包起来‘ ‘，例如：

我是行内代码标记

文本如下：

        `我是行内代码标记`

    

反斜杠

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果，你可以在星号的前面加上反斜杠。

下划线

下划线可以用<u>来表示，用</u>结束。

效果如下：

这是下划线

文本如下：

        <u>这是下划线</u>

    

区块引用

在段落的第一行前面加 > 即可。

效果如下：

引用自己（……）

文本如下：

        >引用自己（……）

    

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ：

效果如下：

第一层区块引用

第二层区块引用

文本如下：

        >第一层区块引用
>>第二层区块引用

    

区块内也可以套用其他的 Markdown 语法，包括加粗、列表、代码区块等。

代码区块

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以(代码区块是单独的一个段落，需要注意空行)，例如，下面的输入：

        hello,world!

    

也可以用 ``` 包裹一段代码，并指定一种语言（也可以不指定）。例如：

        #include<stdio.h>
int main()
{
    printf("Hello world!");
    return 0;
}

    

markdown中的链接与图片

链接

markdown支持三种种形式的连接语法: 行内式和参考式，链接字符不区分大小写。隐式使用较少暂不介绍。

行内式写法如下（注意，是英文的括号）：

        [链接的描述](链接地址)

    

参考式写法如下(有种变量的既视感)：

        [链接的描述](id)
[id]:链接地址

    

效果如下：

我们的博客

这也是我们的博客

文本如下：

        [我们的博客](https://www.cnblogs.com/WHU-TD)

这也是[我们的博客](id)

[id]:https://www.cnblogs.com/WHU-TD

    

图片

插入图片与插入链接的语法类似，也是分为行内式和参考式。地址可以是网络地址，也可以是本地位置

行内式的格式如下：

        ![图片描述](图片地址)

    

参考式的格式如下：

        ![图片描述](id)
[id]:图片地址

    

效果如下：

文本如下：

        ![示例图片2](/upload/getfiles/default/2022/10/29/20221029032012494.jpg)

    

字体

颜色

markedown中的控制字体颜色的语法如下：

        <font color="颜色的RGB码">文字</font><br /> 

    

一些常用颜色

        浅红色文字：<font color="#dd0000">浅红色文字</font><br /> 
深红色文字：<font color="#660000">深红色文字</font><br /> 
浅绿色文字：<font color="#00dd00">浅绿色文字</font><br /> 
深绿色文字：<font color="#006600">深绿色文字</font><br /> 
浅蓝色文字：<font color="#0000dd">浅蓝色文字</font><br /> 
深蓝色文字：<font color="#000066">深蓝色文字</font><br /> 
浅黄色文字：<font color="#dddd00">浅黄色文字</font><br /> 
深黄色文字：<font color="#666600">深黄色文字</font><br /> 
浅青色文字：<font color="#00dddd">浅青色文字</font><br /> 
深青色文字：<font color="#006666">深青色文字</font><br /> 
浅紫色文字：<font color="#dd00dd">浅紫色文字</font><br /> 
深紫色文字：<font color="#660066">深紫色文字</font><br /> 

    

效果如下：

浅红色文字：浅红色文字
深红色文字：深红色文字
浅绿色文字：浅绿色文字
深绿色文字：深绿色文字
浅蓝色文字：浅蓝色文字
深蓝色文字：深蓝色文字
浅黄色文字：浅黄色文字
深黄色文字：深黄色文字
浅青色文字：浅青色文字
深青色文字：深青色文字
浅紫色文字：浅紫色文字
深紫色文字：深紫色文字
蓝色文字：蓝色文字

（<br />用于换行）

大小

markedown中的控制字体大小的语法如下（字体号越大字体越大）：

        <font size="字体号">文字</font><br /> 

    

文本示例：

        size为1：<font size="1">size为1</font><br /> 
size为2：<font size="2">size为2</font><br /> 
size为3：<font size="3">size为3</font><br /> 
size为4：<font size="4">size为4</font><br /> 
size为10：<font size="10">size为10</font><br /> 

    

效果如下：

size为1：size为1
size为2：size为2
size为3：size为3
size为4：size为4
size为10：size为10

字体

markedown中的控制字体类型的语法如下：

        <font face="字体名称">我是黑体字</font>

    

文本示例：

        <font face="黑体">我是黑体字</font><br /> 
<font face="宋体">我是宋体字</font><br /> 
<font face="微软雅黑">我是微软雅黑字</font><br /> 
<font face="fantasy">我是fantasy字</font><br /> 
<font face="Helvetica">我是Helvetica字</font><br /> 

    

效果如下：
我是黑体字
我是宋体字
我是微软雅黑字
我是fantasy字
我是Helvetica字

背景色

markedown中的控制字体背景色语法如下：

        <table><tr><td bgcolor=颜色的RGB码>文字</td></tr></table>

    

文本示例：

        <table><tr><td bgcolor=#FF00FF>背景色的设置是按照十六进制颜色值：#7FFFD4</td></tr></table>
<table><tr><td bgcolor=#FF83FA>背景色的设置是按照十六进制颜色值：#FF83FA</td></tr></table>
<table><tr><td bgcolor=#D1EEEE>背景色的设置是按照十六进制颜色值：#D1EEEE</td></tr></table>
<table><tr><td bgcolor=#C0FF3E>背景色的设置是按照十六进制颜色值：#C0FF3E</td></tr></table>
<table><tr><td bgcolor=#54FF9F>背景色的设置是按照十六进制颜色值：#54FF9F</td></tr></table>

    

效果如下：

原文：https://www.cnblogs.com/WHU-TD/p/13830591.html