当前位置：首页 > news >正文

CSDN Markdown 编辑器语法大全

news 2026/2/8 17:48:24

Markdown 是一种轻量级标记语言，它以简洁、易读易写的特点，被广泛应用于技术文档、博客文章、笔记等领域。CSDN 的 Markdown 编辑器为用户提供了丰富的功能，让用户能够轻松地创建格式规范、内容丰富的文档。以下是一份详细的 CSDN Markdown 编辑器语法使用大全。

一、标题

标题是文档的重要组成部分，能够快速引导读者了解文档的结构和主要内容。

一级标题：使用一个 # 符号，独占一行。例如：# 文档的主标题。渲染效果为字体最大、最醒目，通常作为整个文档的核心主题展示。
二级标题：用两个 # 符号。如：## 章节标题。其字体大小和重要性次于一级标题，用于划分文档的主要章节。
三级标题及以下：依次类推，###、#### 等分别表示不同级别的标题。随着标题级别降低，字体逐渐变小，用于细分文档的具体内容。

二、段落

段落是文档的基本组成单位，清晰的段落结构能提高文档的可读性。

直接输入文本即可创建段落。为了在视觉上区分不同的段落，可以在段落之间插入一个空行。如果要在段落内换行，可以在行末使用两个空格然后按回车键。

例如：这是第一个段落。

这是第二个段落，与上一段落有明显的区分。

三、强调

粗体：使用两个 * 或两个 _ 包裹文本。例如：**这是粗体内容**。渲染效果为字体加粗，突出显示重要的文本内容，吸引读者的注意力。
斜体：用一个 * 或一个 _ 包裹文本。如：*这是斜体内容*。斜体文本给人一种轻微强调的感觉，可用于表示特定的术语或引用的词汇等。
粗斜体：三个 * 或三个 _ 包裹文本。例如：***这是粗斜体内容***。这种强调方式结合了粗体和斜体的特点，进一步突出极其重要又特殊的内容。

四、列表

有序列表：
- 格式为数字加 . 然后跟一个空格。例如：
1. 第一项
2. 第二项
3. 第三项
- 有序列表适合展示具有先后顺序的步骤、流程等内容，让读者能够清晰地了解任务的执行顺序。
无序列表：
- 使用 -、* 或 + 然后跟一个空格。例如：
- 第一项
- 第二项
- 第三项
- 无序列表用于列举没有特定顺序的项目，如优点、缺点、特性等，方便读者快速浏览相关内容。

五、链接

内联链接：[链接显示的文本](链接地址)。例如：[CSDN 官网](https://www.csdn.net/)。当读者点击链接显示的文本时，会跳转到指定的链接地址，方便读者获取更多相关信息。
引用链接：先在文档中定义链接，格式为[链接的名称]: 链接地址，然后在需要插入链接的地方使用[链接显示的文本][链接的名称]。例如：[myLink]: https://www.example.com，[点击这里][myLink]。引用链接适用于在文档中多次使用同一个链接的情况，使文档更加简洁易读。

六、图片

例如：
![请添加图片描述](https://i-blog.csdnimg.cn/direct/5dfe961c0d7c4416bafa3c4b5ae46742.png)。
。当图片无法加载时，替代文本会显示出来，为读者提供关于图片内容的描述。同时，图片可以为文档增添直观的视觉效果，帮助读者更好地理解内容。

七、引用

使用 > 来创建引用。例如：

这是引用的内容。
引用内容通常以缩进的形式显示，与正文区分开来，可用于引用他人的话语、文献资料或突出重要的观点，增加文档的权威性和可信度。

八、代码块

行内代码：用反引号``包裹。如：这是行内代码。行内代码用于在文本中插入少量的代码片段，强调特定的代码部分，与周围的文本区分开来。
代码块：用三个反引号包裹，并在开头反引号后指定代码语言（可选）。例如：

print("Hello, World!")

代码块可以展示大量的代码，并且根据指定的代码语言进行语法高亮显示，使代码更加易读，方便读者理解代码的结构和逻辑。

九、分割线

使用三个或更多的 -、* 或 _ 来创建分割线。例如：
---

***

___

分割线可以将文档内容分隔成不同的部分，使文档结构更加清晰，便于读者区分不同的主题或章节。

十、表格

使用 | 分隔列，- 分隔表头和内容，开头和结尾用 | ---- | ---- | ---- |。例如：

列 1 标题	列 2 标题	列 3 标题
内容 1	内容 2	内容 3
还可以通过在分隔线中使用 `:` 来指定列的对齐方式。如：
左对齐列	居中列	右对齐列
:----	:----:	----:
内容 1	内容 2	内容 3
表格可以用于展示数据、对比信息等，使复杂的信息以整齐的行列形式呈现，方便读者快速浏览和比较。

十一、字体颜色和大小

在 Markdown 中本身没有直接设置字体颜色和大小的语法，但可以通过 HTML 标签来实现。不过这种方式可能在不同的 Markdown 渲染环境中表现不一致。

例如，设置红色字体：这是红色字体。

效果：这是红色字体

 苍麒麟色
 苍绿色
 苍紫罗蓝色
 桃色
 番木色
 粉红
 杨李色
 粉蓝色
紫色
 褐玫瑰红
 宝石红
 重褐色
 鲜肉色
沙褐色
 宝石蓝
 猩红色
 海绿色
海贝色
 赭色
 银白色
 天蓝色
 石蓝色
灰石色
 烟灰色
雪白色
春绿色
钢蓝色
番茄色
 翠蓝色

也可以使用十六进制颜色值
例如red用十六进制颜色值表示为#FF0000，黑色就是#000000,blue为#0000FF。
请添加图片描述

设置字体大小为5号：这是5号字体。

效果：这是5号字体

后面加上　<　/font> 控制范围结束

设置字体为楷体这是楷体

效果：这是楷体

十二、数学公式

CSDN Markdown 编辑器支持 LaTeX 语法来插入数学公式。

行内公式：使用单个 $ 包裹公式。例如： $E = mc^2$ 。
独立公式：使用两个 $$ 包裹公式。例如：
$F = ma$

十三、待办事项列表

使用 - [ ] 表示未完成的事项，使用 - [x] 表示已完成的事项。例如：

任务一
任务二

十四、脚注

可以使用脚注来为文档中的特定内容添加注释。

例如：这是一个需要注释的内容¹。

然后在文档的任意位置添加脚注的定义：

十五、目录

在文档的开头可以使用 [TOC] 来生成目录。目录会自动根据文档中的标题生成，方便读者快速浏览文档的结构和内容。

十六、高级用法

嵌套列表和引用：可以在列表项中嵌套列表和引用，以创建更复杂的文档结构。
- 例如：
- 第一项
  - 子项一
  - 子项二
- 第二项
  
  引用内容
链接和图片的组合：可以在链接中插入图片，以创建更丰富的链接效果。
- 例如：[这是一个链接，包含一张图片](https://example.com/image.jpg)。
代码块中的注释：在代码块中可以使用注释来解释代码的功能和实现方法。
- 例如：

# 这是一个注释
print("Hello, World!")

表格的高级样式：可以使用 HTML 标签来为表格添加高级样式，如边框、背景颜色等。
- 例如：

<table border="1" style="background-color:lightgray;">
<tr>
<td>列 1 标题</td>
<td>列 2 标题</td>
<td>列 3 标题</td>
</tr>
<tr>
<td>内容 1</td>
<td>内容 2</td>
<td>内容 3</td>
</tr>
</table>

十七、注意事项

兼容性问题：不同的 Markdown 渲染环境对语法的支持程度可能会有所不同。在使用特定的语法时，最好在实际的环境中进行测试，确保语法能够正确显示。
简洁性和可读性：虽然 Markdown 提供了丰富的语法，但过度使用可能会使文档显得杂乱无章，影响阅读体验。应该保持文档的简洁性和可读性，只在需要的时候使用特定的语法。
安全性问题：在插入外部链接和图片时，要确保链接和图片的来源可靠，以避免安全风险。
备份和版本控制：在编辑重要的文档时，最好定期进行备份，并使用版本控制工具来管理文档的版本，以防止数据丢失。

总之，CSDN Markdown 编辑器提供了丰富的语法和功能，让用户能够轻松地创建格式规范、内容丰富的文档。通过掌握这些语法和功能，用户可以提高文档的质量和可读性，更好地分享知识和经验。同时，也要注意兼容性、简洁性、安全性等问题，以确保文档的质量和可靠性。

这是脚注的内容我是注释。 ↩︎