MarkDown 基本语法

MarkDown 基本语法

MarkDown 是一种纯文本格式的标记语言,通过简单的标记语法,可以使普通的文本具有一定的格式。它是将文档以 HTML 格式发布,最终的显示效果取决于前端的渲染。MarkDown 也可以理解为将以 MarkDown 语法编写的纯文本转换成 HTML 的工具,最终在网页显示 HTML 内容。

目录


一、标题

使用 # 表示 1~6 级标题

标准语法是在 # 后跟一个空格,1 个 # 表示一级标题,2 个 ## 表示二级标题

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

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

一级标题和二级标题还可以通过 ===--- 符号标记,标记方式如下:

一级标题
===
二级标题
---

效果如下:

一级标题

二级标题

二、目录

目录使用 [显示文字](#段落中的标题) 的形式链接到当前文档的特定位置,如下写法可连接到本文档的 九、列表 位置处,写法如下

[链接到第九章](#九、列表)

效果如下
链接到第九章

三、段落

需要使用空行分段,即段落的前后需要是空行,只回车换行在显示效果中是没有换行效果的。
若想在一个段落内换行,需要在行尾加上至少两个空格,再回车换行。
若想在特定位置加入空行,可以在使用 <br> 表示空行,如下所示:

直接回车换行
不能实现换行功能
行末加两个空格
实现换行
使用<br>表示换行<br><br>换两行

效果如下:

直接回车换行
不能实现换行功能
行末加两个空格
实现换行
使用
表示换行

换两行

四、字体

  • 粗体
    使用 **粗体文字** 的形式,在要加粗的文字两端使用两个 ** 包裹起来

    粗体文字

  • 斜体
    使用 *斜体文字* 的形式,在文字的两端使用 * 包裹起来

    斜体文字

  • 删除线
    使用 ~~删除线文字~~ 的形式,在文字的两端使用 ~~ 包裹起来

    删除线文字

以上方式还可以组合使用,如下所示

***加粗的斜体文字***
~~*斜体带删除线文字*~~
~~**加粗带删除线文字**~~
~~***加粗的斜体带删除线文字***~~

效果如下

加粗的斜体文字
斜体带删除线文字
加粗带删除线文字
加粗的斜体带删除线文字

五、引用

引用在行首加 > 符号即可,还可嵌套引用,输入多个 > 即可,如下所示

> 引用
>> 嵌套引用
>>> 多层嵌套引用

效果如下

引用

嵌套引用

多层嵌套引用

六、分割线

分割线使用三个或三个以上的 -* 符号

---
***

效果如下



注意,在使用 --- 符号时,上一行应当是空行,否则其会将上一行解释为二级标题,而不是分割线

七、超链接

超链接使用 [超链接名](超链接地址 "超链接标题") 的语法,其中 "超链接标题" 可写可不写,其效果为鼠标悬停时显示的文字

[百度](https://www.baidu.com "百度网址")

效果为
百度

八、图片

插入图片的语法和插入超链接类似,只需在链接前面加上 ! 即可,语法如下

![图片alt](图片地址 "图片title")

其中图片地址可以是本地路径,也可以是网络图片

九、列表

  • 无序列表
    使用 +-、或 * 标记无需列表,如下写法

    + 第一项
    - 第二项
    * 第三项

    效果如下

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

还可以通过写 <li> 的形式标记列表项,如下写法

<li> 项一
<li> 项二

效果为(部分解释器可能不支持)

<li> 项一
<li> 项二

  • 有序列表
    使用 数字. 来表示,一般列表的第一个数字为起始编号数字,后面会自动加一排序,如下写法

    1. 有序第一行
    2. 有序第二行
    3. 有序第三行

    2. 有序第一行
    8. 有序第二行
    1. 有序第三行

    效果如下

    1. 有序第一行
    2. 有序第二行
    3. 有序第三行
    1. 有序第一行
    2. 有序第二行
    3. 有序第三行

还可以通过写 <ol start="1"><li>……<li> 的形式写有序列表,如下写法(部分解释器可能不支持):

<ol><li> 有序项一
<li> 有序项二

<ol start="5"><li> 有序项一
<li> 有序项二

效果为:

<ol><li> 有序项一
<li> 有序项二

<ol start="5"><li> 有序项一
<li> 有序项二

注意:在列表中,若想实现缩进,即一个列表项下想把较多的内容都缩进到列表项后面,需要在换行后的内容的行首加3个空格

列表嵌套
列表嵌套需要在下一级列表前输入3个空格,如下写法(此处用 s 表示空格)

1. 一级有序列表
sss* 二级无需列表

效果如下

  1. 一级有序列表
    • 二级无需列表

十、表格

表格语法如下

|表头1|表头2|表头3|
|:---|:---:|----:|
|内容|内容|内容|
|a|b|c|

显示效果如下

表头1 表头2 表头3
内容 内容 内容
a b c

其中,最前面一列和最后一列的 | 可以省略不写,第二行中的 : 指示此列的对齐方式,写在左面为左对齐,写在右面为右对齐,写在两端为居中

表格中写列表时,可以采用第九章中描述的 <li><ol><li> 标记的形式实现,如下写法:

|表头1|表头2|表头3| 
|:---|:---:|----|
|内容|内容|内容描述,下面是列表<br><li> 选项一 <li> 选项二|
|a|b|比较长的内容,下面是有序列表<br><ol start="1"><li> 有序选项一 <li> 有序选项二|

显示效果为(部分解释器可能不支持):

表头1 表头2 表头3
内容 内容 内容描述,下面是列表
<li> 选项一 <li> 选项二
a b 比较长的内容,下面是有序列表
<ol start="1"><li> 有序选项一 <li> 有序选项二

十一、其它符号

  • 转义符号 \
    转义符号 \ 用于输出特殊符号

  • 代码标识符号 '`'
    代码标识符号 ' ` ' 用于标记代码,行内使用时,使用 `代码` 完成行内标记,如: 代码
    当不使用行内代码,而是标记代码段时,在代码段的前后用 ``` 包裹起来,如:

    ```
    int add(int a, int b)
    {
    \qquadreturn a + b;
    }
    ```

    效果为

    int add(int a, int b)
    {
        return a + b;
    }
    

    可以手动指定代码的语言类型,语法为在第一个 '```' 后写上语言名称,如上所示代码写成下面的形式:

    ```cpp
    int add(int a, int b)
    {
    \qquadreturn a + b;
    }
    ```

    效果为:

    int add(int a, int b)
    {
        return a + b;
    }
    
  • 数学公式转义符号 $

    数学公式转义符号用于转义数学公式,当使用行内公式时,使用一个 $ 符号 包裹公式,使用单独一行的公式时,使用 $$ 包裹公式,如下:

    行内公式:$f(x)=ax+b$
    $$E=mc^2$$

    效果为:

    行内公式:f(x)=ax+b
    E=mc^2

    关于数学公式的具体用法请参见:


雷震西山 2019年10月20日

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,009评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,808评论 2 378
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,891评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,283评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,285评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,409评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,809评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,487评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,680评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,499评论 2 318
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,548评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,268评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,815评论 3 304
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,872评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,102评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,683评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,253评论 2 341

推荐阅读更多精彩内容

  • HTML5 File API 在 HTML5 的 input 标签中,新增了一个 type=file 属性的表单控...
    多云转晴i阅读 306评论 0 1
  • 【标题】认知不够,努力白费 【字数】530字 【正文】 2019年10月1日,是新中国成立七十周年,随处可见的红旗...
    徐徐成峰阅读 53评论 0 0
  • 2 019年10月19日成长日记 商洛彤妈诵读《易经》、《中庸》、《唐诗三百首》。 卡顿中的手机:金老师教我们要及...
    商洛彤妈阅读 172评论 1 0
  • 我之前写过一篇文章《变》,从讲自己的体重变大而引出的一系列生活中的问题,之后要如何如何改变。其中我说自己早晨起不来...
    非苏力阅读 598评论 1 0
  • 昨晚临时决定带上小妞去医院看奶奶。 自从国庆节奶奶住了院,她就一直没能见到奶奶。 作为从小被奶奶带大的娃,妞儿时不...
    山间竹音阅读 187评论 0 0