Markdown语法讲解(上)——基本语法

Markdown语法讲解(上)——基本语法

********* 本文参考了

Markdown语法图文全面详解(10分钟学会)
B站up: "救救-99" 的Markdown保姆级教程视频

须知:此文章是个人的随手笔记,不是专业教程,仅供各位小伙伴参考

TOC

1 分级标题

一级标题的markdown语法规则为:

# 一级标题内容

注意:#与标题内容之间有一个“空格”;

二级标题的markdown语法规则为:

## 二级标题内容`

三级标题的Makedown语法规则为:

## 二级标题内容

以此类推……


2 设置<字体、字号与字体颜色>

2.1 字体

给文字设置字体的markdown语法规则为:

<font face="字体名称">文字内容</font>

例如在markdown编辑器中编写下面代码:

<font face="等线">消灭恐惧的最好办法就是面对恐惧,加油,奥利给!</font>

显示效果:

<font face="等线">消灭恐惧的最好办法就是面对恐惧,加油,奥利给!</font>

2.2 字号

给文字设置字号的markdown语法规则为:

<font size=字号大小>文字内容</font>

例如在markdown编辑器中编写下面代码:

<font size=5>消灭恐惧的最好办法就是面对恐惧,加油,奥利给</font>

显示效果:

目前简书暂不支持该语法,此处内容无法显示!

2.3 字体颜色设置

颜色是按照24位的十六进制RGB信息确定的,例如红色的24位的十六进制RGB信息为:

#FF0000

给文字设置字体颜色的markdown语法规则为:

<font color=#24位的十六进制RGB信息>文字内容</font>

例如在markdown编辑器中编写下面代码:

<font color="FF0000">加油,奥利给!</font>

显示效果:

<font color="FF0000">加油,奥利给!</font>

2.4 设置背景颜色

对应语法:

<table><tr><td bgcolor=#6位16进制颜色值>文字背景颜色</td></tr></table>

例如(同时我还把文字设置成白色):

<table><tr><td bgcolor=#000000><font color=FFFFFF>文字背景颜色</td></tr></table>

显示效果:

简书无法显示

2.5字体、字号和字体颜色效果合并

给文字设置字体、字号和字体颜色的markdown语法规则为:

<font face="字体名称" size=字号大小 color=#24位的十六进制RGB信息>文字内容</font>

例如在markdown编辑器中编写下面代码:

<font face="等线" size=5 color=#FF0000>加油,奥利给!</font>

HTML显示效果:

<font face="等线" size=5 color=#FF0000>加油,奥利给!</font>


3 设置<斜体、粗体、删除线、下标与上标>

3.1 斜体

字体设置斜体的markdown语法规则为:

*文字内容*

或者

_文字内容_

例如在markdown编辑器中编写下面代码:

*Thank you!*

HTML显示效果:

Thank you!

3.2 粗体

字体设置粗体的markdown语法规则为:

**文字内容**

例如在markdown编辑器中编写下面代码:

**Thank you!**

HTML显示效果:

Thank you!

3.3 删除线

设置删除线的markdown语法规则为:

~~文字内容~~

例如在markdown编辑器中编写下面代码:

~~Thank you!~~

显示效果:

Thank you!

这些效果可以叠加使用,比如在markdown编辑器中编写下面代码:

~~***Thank you!***~~

HTML显示效果:

Thank you!

3.4 下标

在下标内容两侧插入波浪线~

例如:

H~2~O

显示效果:

H2O


3.5 上标

在下标内容两侧插入上标符号^

例如:

a^2^+b^2^=1

显示效果:

a2+b2=1


4 插入<图片>

4.1 插入本地图片

插入本地图片的markdown语法规则:

![图片描述](图片路径)

可以采用相对路径或者绝对路径,如果图片放在本文档的文件夹下,可以采用相对路径,否则采用绝对路径。

  • 利用相对路径插入图片,例如在markdown编辑器中输入下面代码:
![《云之彼端,约定的地方》](云之彼端约定的地方3.jpg)
  • HTML显示效果:
云之彼端约定的地方3.jpg
  • 利用绝对路径插入图片,例如在markdown编辑器中输入下面代码:
![《云之彼端,约定的地方》](G:\101-Pictures\截屏图片\云之彼端约定的地方\云之彼端约定的地方2.jpg)
  • HTML显示效果:
云之彼端约定的地方2.jpg

注意:对于想要在hexo博客中插入图片,如果上传的.md文件直接用这里的插入图片的Markdown语法规则将会导致显示失败,也即是说这里的插入本地图片语法不能用在需要上传到hexo博客的.md文件中。

在hexo博客的文章中插入本地图片对应的语法规则为:

{% asset_img 图片路径.jpg 图片描述%}

例如:

{% asset_img 云之彼端约定的地方3.jpg 《云之彼端,约定的地方》%}

其中,图片路径是你要上传的.md文件的相对路径,该图片存放在一个与这个.md文件同名的的文件夹下。

在此之前,还需要安装相关的上传本地图片的插件hexo-asset-image才能实现在hexo博客文章中插入本地图片的功能。

在你的博客文件夹下,运行cmd或者git bash,输入下面代码来安装hexo-asset-image插件:


npm install hexo-asset-image --save

4.2 插入网络图片

插入网络图片的markdown语法规则:

![图片描述](网络图片路径)

例如在markdown编辑器中输入下面代码:


![言叶之庭](https://ss1.bdstatic.com/70cFvXSh_Q1YnxGkpoWK1HF6hhy/it/u=3696447164,3237893343&fm=15&gp=0.jpg)

HTML显示效果:

言叶之庭

4.3 Typora插入图片

打开Typora软件,点击菜单栏的文件,然后依次点击偏好设置 - 图像,选择复制图片到当前文件夹或者其他保存路径,并勾选下面的选项,如下图所示:

Typora插入图片.png

Typora 的图片插入功能是广受好评的。要知道,Markdown 原生不太注重图片插入的功能,但你可以在 Typora 中:拖动图片到文档中,Typora 会自动帮你插入符合 Markdown 语法的图片语句,并给它加上标题。

<font face="等线" size=5 color=#FF0000> Typora软件具有插入<图片、代码块、表格等>等选项,软件会自动添加相应的代码,大大方便了用户的使用</font>


5 跳转

5.1 外部跳转——超链接

外部跳转格式为:

[外部跳转链接内容描述](链接地址)

例如在markdown编辑器中输入下面内容:

[Markdown语法图文全面详解(10分钟学会)](https://blog.csdn.net/u014061630/article/details/81359144)

HTML显示效果:

Markdown语法图文全面详解(10分钟学会)

5.2 内部跳转——文件内跳转

内部跳转格式为:

[跳转内容描述](#要跳转的标题)

例如在markdown编辑器中输入下面内容:

[跳转顶部](#Makedown语法讲解(上)——基本语法)

6 添加<自动链接>

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。也可以直接写,同样可以显示成链接形式。

例如:

<https://lijinlong1997.github.io/>
或

https://lijinlong1997.github.io/

<18207748817@163.com>

或

18207748817@163.com

显示效果:

https://lijinlong1997.github.io/

18207748817@163.com


7 插入<代码块>

7.1 行内代码

如果在一个行内需要引用代码,只要用反引号`引起来就好(一般在ESC键下方,和~同一个键)

例如输入:

`assign c = a + b;`

显示效果

assign c = a + b;

7.2 多行代码

多行代码块与语法高亮:在需要高亮的代码块的前一行及后一行使用三个单反引号“`”包裹,就可以了,还可以在第一个单反双引号后输入相应的语言。

例如输入:

```verilog

always@(posedge Clk or negedge Rst_n)

if(!Rst_n)

  c <= 1'b0;

else

  c <= a + b;

​```

显示效果:

always@(posedge Clk or negedge Rst_n)

if(!Rst_n)

  c <= 1'b0;

else

  c <= a + b;

8 插入<表格>

表格的基本写法简单,和表格的形状相似:

例如输入:

| xxx | xxx | xxx |

| --- | --- | --- |

| xxx | xxx | xxx |

| xxx | xxx | xxx |

显示效果:

目前简书暂不支持该语法,此处内容无法显示

xxx表示要输入的内容,其中竖线|不用严格对齐,对其与否,不影响最后的显示。

可以利用冒号:设置单元格内容的对齐方式,冒号在左边表示左对齐,右边表示有对齐,两边都有表示居中。

例如输入:

| xxx  | xxx  | xxx  |

| :--- | :--- | :--- |

| xxx  | xxx  | xxx  |

| xxx  | xxx  | xxx  |

显示效果:

目前简书暂不支持该语法,此处内容无法显示

在Tpyora等Markdown编辑器中有插入表格选项,直接插入表格后,软件会自动添加相应的表格代码到源代码中去,而不需要输入这些繁琐的标记内容。


9 添加<列表>

9.1 无序列表

使用 *,+,- 表示无序列表,注意:符号后面一定要有一个空格,起到缩进的作用。

例如:

* 列表内容1

* 列表内容2

* ……

显示效果:

  • 列表内容1

  • 列表内容2

  • ……

9.2 有序列表

使用数字和一个英文句点表示有序列表, 注意:英文句点后面一定要有一个空格,起到缩进的作用。

例如:

1. 内容1

2. 内容2

3. ……

显示效果

  1. 内容1

  2. 内容2

注意事项 :

在使用列表时,只要是数字后面加上英文的点,就会无意间产生列表,比如2020.04.25这时候想表达的是日期,有些软件把它被误认为是列表。解决方式:在每个点前面加上\就可以了。

比如:

2020\.04\.25

显示效果:

2020.04.25

还有,比如你就是想打**Thank you**,直接输入**Thank you**是不行的,因为根据Markdown语法会转换成粗体,这时候我们就可以多输入一个转义字符\,来表达\后的内容就是你想表达的就行了,即:

\*\*Thank you**

显示效果:

**Thank you**


10 添加分割线

在一行中用三个以上的星号(*)、减号(-)、底线(_)来建立一个分隔线,行内不能有其他东西。

格式为:

---

***

___

11 引用

在被引用的文本前加上>符号,以及一个空格就可以了,如果只输入了一个>符号会产生一个空白的引用。

例如:

> 文字内容

显示效果:

引用内容

除基本的引用外,还有嵌套引用等


12 其他操作

12.1 创建目录

在段落中输入[TOC]即可在本位置创建目录。

例如:

[TOC]

12.2 添加脚注

脚注就是在需要添加脚注的文字的后面加上脚注名字。

语法:

文字[^脚注名字]

例如:

IC[1]FPGA[2]

然后在文中(一般在页尾或者文章末尾)添加对应的脚注内容

12.3 添加emoji表情

输入英文冒号`:`后输入你想表达的内容的单词,这个功能不是很方便,需要自己记住你想用的表情的单词,而且有些平台不支持。

例如:

:cow

显示结果:

简书无法显示

下一篇:Markdown语法讲解(下)——高级语法


  1. Integrated circuit 集成电路

  2. Field Programmable Gate Array 现场可编程门阵列

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

推荐阅读更多精彩内容

  • 关于Markdown 一整个学期下来,我觉得让我收获最大之一的是学会markdown语言。我们平常都是使用Word...
    Dacade阅读 935评论 0 2
  • (Markdown语法没有一个统一的标准,不同的工具或平台采用的标准不一样,所以有些语法规则和功能是有差异的) 0...
    迟道阅读 56,735评论 4 69
  • NOTE: This is Simplelified Chinese Edition Document of Ma...
  • << 访问 Wow!Ubuntu NOTE: This is Simplelified Chinese Edit...
    临城阅读 6,524评论 4 44
  • 一个好久不见的网友,忽然打招呼了,心情异常的复杂,本来认为已经彻底失去了这个网友,但是又重新的闯入了我的网络世界....
    OO碰到OO阅读 183评论 0 0