Markdown语法——基础语法篇（平台：vscode）

本文链接：https://blog.csdn.net/chuiertujing/article/details/134287280

Markdown基础语法

写在前面：

此篇博客是Markdown的基本语法篇，但我认为作为日常书写记录的语法完全够用了！

扩展语法篇的内容相对较难，针对的是一些特别需求，如合并单元格，设置文字背景色等内容。由于Markdown本身没有提供相应语法，更多是使用HTML语言实现的。在这篇博客的相关内容处也放置了对应扩展内容的说明和链接，可以直接跳转。如果想学习扩展语法，也可以点击这里，跳转Markdown扩展语法篇。

此篇博客主要借鉴了Markdown官方教程文档。

本篇博文（以及所有博客）的 .md/html 文档都在我的 Gitee 仓库中，我会根据博客实时更新的，有需要的伙伴可以自行下载~！

标题语法

书写：

在标题前添加井号#；
#的数量代表了标题的级别；
考虑到不同mkd应用程序的兼容性，在#和标题之间用一个空格进行分隔。

示例：
# Heading level 1(<h1>)
## Heading level 2(<h2>)

换行语法

书写：

法1：在一行末尾添加至少两个空格然后按回车键；
法2：在行末使用<br>(line break)创建一个换行。

示例：

This is the first line.  
And this is the second line. <br>And this is the third line.

效果：
This is the first line.
And this is the second line.
And this is the third line.

段落语法

书写：在段落之间使用空白行进行分隔。

示例 & 效果：
I really like using Markdown.

I think I`ll use it format all of documents from now on.

强调语法

粗体(Bold)

书写：

法1：在要加粗的文字前后各添加两个星号**，如**text here**；
使用一对标签<strong>text here</strong>，实现文字加粗。

示例：

**The bold text.**  
<strong>The bold text.</strong>

效果：
The bold text.
The bold text.

斜体(Italic)

书写：

法1：在要斜体显示的文字前后各添加一个星号*，如*text here*；
使用一对标签<em>text here</em>，实现文字斜体显示。

示例：

Italicized text is the *cat’s meow*.  
Italicized text is the <em>cat’s meow</em>.

效果：
Italicized text is the cat’s meow.
Italicized text is the cat’s meow.

粗体和斜体

书写：

法1：在要加粗并斜体显示的文字前后各添加三个星号***，如***text here***；
法2：添加对称的<strong><em>text here</em></strong>，实现文字斜体显示。

示例：

***This text is really important.***
<strong><em>This text is really important.</em></strong>

效果：
This text is really important.
This text is really important.

删除线

书写：在删除显示的文本前后添加两个波浪号~~，如~~text here~~。

示例：

给你一朵~~红玫瑰~~黄玫瑰的记忆

效果：
给你一朵~~红玫瑰~~黄玫瑰的记忆

文字居中

使用居中标签<center></center>设置文字居中显示。

示例：

<center>text here</center>

效果：

text here

修改字体、字号、颜色，设置背景色等内容在Markdown扩展篇，点此跳转。

引用语法

书写：在要引用的段落前添加>符号创建引用块。

示例：

> this is a cite.

效果：

this is a cite.

块引用可以包含多个段落，为段落之间的空白行添加一个>即可。

示例：

> 我给你你出生多年前的
>
> 一朵黄玫瑰的记忆

效果：

我给你你出生多年前的

一朵黄玫瑰的记忆

块引用嵌套内容在Markdown扩展语法篇，点击跳转。

分割线语法

书写：在单独一行上使用三个破折号---，该行不能包含其他内容。

示例：

---

列表语法

有序列表

书写 & 效果：

在每个列表前添加紧跟英文句点.的数字；
数字不必顺序排列，但要从1起始；
缩进一个或多个列表(Tab)可创建嵌套列表。
1. 看
2. 这个列表本身就是渲染效果

无序列表

书写：

在每个列表前添加-创建无序列表；
缩进一个或多个列表(Tab)可创建嵌套列表。

示例：

- First item
- Second item
  - First item
  - Second item
    - First item

效果：

First item
Second item
- First item
- Second item
  - First item
如何在列表嵌套其他元素（列表、代码、图片）而不破坏列表连续性等内容在Markdown扩展语法篇，点击跳转。

代码语法

行内代码

书写：

将要显示成代码的文字包裹在反引号(`)中，以创建行内代码；
如果文字中包含反引号，使用双反引号将其包裹。

示例：

Use `code` in my documents.
``Use `code` in my documents.``

效果：
Use code in my documents.
Use `code` in my documents.

代码块

书写：

在代码块前后添加三个反引号`` `````或波浪号~~~；
若要使用语法高亮，需在代码块前的三个反引号后指定语言（c c++ java HTML等）。

示例：

    ```c
    int main()
    {
        int i = 0;
        printf("%d\n", i);
        return 0;
    }
    ```

效果：

int main()
{
    int i = 0;
    printf("%d\n", i);
    return 0;
}

表格语法

书写要点：

使用三个或多个连字符---创建每列的标题；
使用管道|分隔每列；
在标题连字符---左侧或右侧添加冒号:设置表格内文字的位置。
1. :---使表格内的文本左对齐
2. :---:使表格内的文本居中
3. ---:使表格内的文本右对齐

示例：

|title1|title2|title3|
|:---|:---:|---:|
|`code`|text|**bold**|
||<https://markdown.com.cn/extended-syntax/tables.html>|

效果：

title1	title2	title3
`code`	text	bold
	https://markdown.com.cn/extended-syntax/tables.html

转义管道字符，需使用HTML字符代码|，使表中显示|。
合并单元格、设置表格和单元格内文本的对齐方式等内容在扩展语法篇，点击跳转。

数学公式

书写：

在LaTex语法前后分别插入一个$创建行内公式；
在LaTex语法前后分别插入两个$创建行间公式；
运算符的元素多于两个时，用中括号{}将元素括起来。

推荐插件：MarkdownTools有常用符号，还可以在线设计公式。

常见符号：

符号或结构	语法
$\alpha$	\alpha
$\beta$	\beta
$\chi$	\chi
$\frac{ab}{cd}$	\frac{ab}{cd}
$\sqrt{abc}$	\sqrt{abc}
上标	^
下标	_

示例：

牛顿第二定律公式是：$F=ma$。
$$v_t^2-v_0^2=2ax$$

效果：
牛顿第二定律公式是： $F = ma$ 。
$v_t^2-v_0^2=2ax$

链接语法

链接title是当鼠标悬停在链接上时会出现的文字。

语法：
[超链接显示名](超链接地址 "超链接title")

书写要点：

链接显示文本放在中括号内[显示文本]；
链接地址放在显示文本后面的括号内[显示文本](URL)；
若要添加链接title，需要添加在超链接地址后，中间以一个空格连接。
(URL "超链接title")

示例：

这是一个链接[Markdown语法](https://markdown.com.cn/basic-syntax/ "官方Markdown语法教程网站")。

效果：
这是一个链接Markdown语法。

网址和Email地址

书写：将链接的网址和Email放在尖括号<>内，使其变成可点击的链接。

示例：

<https://markdown.com.cn/basic-syntax/>
<3568970551@qq.com>

效果：
https://markdown.com.cn/basic-syntax/
3568970551@qq.com

带格式化的链接

书写：

强调链接，在链接前后增加相应个数的星号实现相应的强调效果；
若要将链接显示为代码，需在方括号中添加反引号。

示例：

I love this ***[instructions](https://markdown.com.cn/basic-syntax/)***.
I love this [`instructions`](https://markdown.com.cn/basic-syntax/).

效果：
I love this instructions.
I love this instructions.

脚注和引用类型链接等内容在扩展语法篇，点击跳转。

图片语法

普通图片

书写：![图片alt](图片链接 "图片title")
书写：在感叹号!后的方括号内添加替代文本，图像的Markdown链接放在圆括号内，链接后可以增加一个可选的title。

如果和我一样使用Vscode写md文档，推荐使用插件Image Paste，直接去扩展搜索下载就可以了。使用该插件后，复制图片，再粘贴到文档任意位置，可自动产生图片链接。

示例：

![Alt text](https://img2023.cnblogs.com/blog/3258107/202311/3258107-20231107210109373-1183604037.jpg"这是章鱼哥")

效果：
Alt

链接图片

语法：
[![Alt text](Markdown "title")](URL)

书写：将图像的Markdown扩在方括号内，然后在方括号后的圆括号内添加跳转链接。

示例：

[![Alt text](https://img2023.cnblogs.com/blog/3258107/202311/3258107-20231107210109373-1183604037.jpg "跳去Bing搜索")](https://cn.bing.com/?ensearch=1&mkt=zh-CN)

效果：