markdown语法教学

什么是markdown语法？

Markdown 是一种轻量级标记语言，用简单的符号标记文本格式，无需复杂排版操作就能生成结构化文档。

它的核心价值在于 “易读易写”，既适合日常记录（如笔记、待办），也能用于创作（如文章、报告），且生成的内容可轻松转换为 HTML、PDF 等格式。

核心优势

  1. 语法简单：仅需记住十几个基础符号，几分钟就能上手。
  2. 跨平台兼容：几乎所有笔记软件（如 Notion、Obsidian）、写作平台（如知乎、GitHub）都支持 Markdown。
  3. 专注内容：无需频繁点击格式按钮，用符号就能快速设置标题、列表等，减少排版干扰。

常用基础语法

标题：

在本软件中一共有6级标题 有几个#就是几级

加粗：

这是一段加粗文本

1
**这是一段加粗文本**

斜体:

这是一段斜体文本

1
*这是一段斜体文本*

转义

如果你只是想要这个符号不想生成对应格式，可以使用” \ “转义

正常输入一段内容需要用到 *

1
2*3*3=

会变成这样：

233=

转义后则为

1
2\*3\*3=

2*3*3=

引用：

这是一段引用文本

1
>这是一段引用文本

代码：

printf（"Hello world"）;这是一段c代码

1
`printf（"Hello world")`

代码块:

快捷键：Ctrl+Shift+K

或这样

1
//这是一个c语言的代码块
1
​```c

先写三个 ` 再跟上对应的语言名称然后回车 如 ```java ```python等也可以不指定语言

就像这样

1
​```
1

链接

通常复制链接进来编译器会自动变为链接格式Markdown 基本语法 | Markdown 教程

1
这是一个链接 [Markdown语法](https://markdown.com.cn)
1
[这里放链接名，不点击的话只会显示这个](这里放链接会自动隐藏点击可显示)

给链接增加 Title

链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔。

1
这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。

渲染效果如下：

这是一个链接Markdown语法

网址和Email地址

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

1
2
<https://markdown.com.cn>
<fake@example.com>

渲染效果如下：

https://markdown.com.cn(opens new window)
fake@example.com

带格式化的链接

强调 链接, 在链接语法前后增加星号。 要将链接表示为代码，请在方括号中添加反引号。

1
2
3
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).

渲染效果如下：

I love supporting the EFF (opens new window).
This is the Markdown Guide (opens new window).
See the section on code.

图片

引用本地图片

快捷键Ctrl+Shift+I

路径可以是相对路径也可以是绝对路径

1
![这是图片名字](这是图片路径)

这是图片名字

“D:\垃圾堆\学长课堂\第二课\风景.png”

这是图片名字

也可以直接复制粘贴图片但是要在偏好设置中修改

1

1

设置后可以直接复制粘贴图片到文本中，会自动在当前目录创建一个文件夹存放图片

/image-20251102120109488

image-20251102120127938