Markdown 是一种轻量级标记语言，它以简洁、易读易写的特点，被广泛应用于技术文档、博客文章、笔记等领域。CSDN 的 Markdown 编辑器为用户提供了丰富的功能，让用户能够轻松地创建格式规范、内容丰富的文档。以下是一份详细的 CSDN Markdown 编辑器语法使用大全。
一、标题
标题是文档的重要组成部分，能够快速引导读者了解文档的结构和主要内容。
- 一级标题：使用一个
#符号，独占一行。例如：# 文档的主标题。渲染效果为字体最大、最醒目，通常作为整个文档的核心主题展示。 - 二级标题：用两个
#符号。如：## 章节标题。其字体大小和重要性次于一级标题，用于划分文档的主要章节。 - 三级标题及以下：依次类推，
###、####等分别表示不同级别的标题。随着标题级别降低，字体逐渐变小，用于细分文档的具体内容。
二、段落
段落是文档的基本组成单位，清晰的段落结构能提高文档的可读性。
直接输入文本即可创建段落。为了在视觉上区分不同的段落，可以在段落之间插入一个空行。如果要在段落内换行，可以在行末使用两个空格然后按回车键。
例如：这是第一个段落。
这是第二个段落，与上一段落有明显的区分。
三、强调
- 粗体：使用两个
*或两个_包裹文本。例如：**这是粗体内容**。渲染效果为字体加粗，突出显示重要的文本内容，吸引读者的注意力。 - 斜体：用一个
*或一个_包裹文本。如：*这是斜体内容*。斜体文本给人一种轻微强调的感觉，可用于表示特定的术语或引用的词汇等。 - 粗斜体：三个
*或三个_包裹文本。例如：***这是粗斜体内容***。这种强调方式结合了粗体和斜体的特点，进一步突出极其重要又特殊的内容。
四、列表
- 有序列表：
- 格式为数字加
.然后跟一个空格。例如：
- 第一项
- 第二项
- 第三项
- 有序列表适合展示具有先后顺序的步骤、流程等内容，让读者能够清晰地了解任务的执行顺序。
- 格式为数字加
- 无序列表：
- 使用
-、*或+然后跟一个空格。例如： - 第一项
- 第二项
- 第三项
- 无序列表用于列举没有特定顺序的项目，如优点、缺点、特性等，方便读者快速浏览相关内容。
- 使用
五、链接
- 内联链接：
[链接显示的文本](链接地址)。例如：[CSDN 官网](https://www.csdn.net/)。当读者点击链接显示的文本时，会跳转到指定的链接地址，方便读者获取更多相关信息。 - 引用链接：先在文档中定义链接，格式为
[链接的名称]: 链接地址，然后在需要插入链接的地方使用[链接显示的文本][链接的名称]。例如：[myLink]: https://www.example.com，[点击这里][myLink]。引用链接适用于在文档中多次使用同一个链接的情况，使文档更加简洁易读。
六、图片
例如：
。
。当图片无法加载时，替代文本会显示出来，为读者提供关于图片内容的描述。同时，图片可以为文档增添直观的视觉效果，帮助读者更好地理解内容。
七、引用
使用 > 来创建引用。例如：
这是引用的内容。
引用内容通常以缩进的形式显示，与正文区分开来，可用于引用他人的话语、文献资料或突出重要的观点，增加文档的权威性和可信度。
八、代码块
- 行内代码：用反引号
``包裹。如：这是行内代码。行内代码用于在文本中插入少量的代码片段，强调特定的代码部分，与周围的文本区分开来。 - 代码块：用三个反引号包裹，并在开头反引号后指定代码语言（可选）。例如：
print("Hello, World!")
代码块可以展示大量的代码，并且根据指定的代码语言进行语法高亮显示，使代码更加易读，方便读者理解代码的结构和逻辑。
九、分割线
使用三个或更多的 -、* 或 _ 来创建分割线。例如：
---
***
___
分割线可以将文档内容分隔成不同的部分，使文档结构更加清晰，便于读者区分不同的主题或章节。
十、表格
使用 | 分隔列，- 分隔表头和内容，开头和结尾用 | ---- | ---- | ---- |。例如：
| 列 1 标题 | 列 2 标题 | 列 3 标题 |
|---|---|---|
| 内容 1 | 内容 2 | 内容 3 |
还可以通过在分隔线中使用 : 来指定列的对齐方式。如： | ||
| 左对齐列 | 居中列 | 右对齐列 |
| :---- | :----: | ----: |
| 内容 1 | 内容 2 | 内容 3 |
| 表格可以用于展示数据、对比信息等，使复杂的信息以整齐的行列形式呈现，方便读者快速浏览和比较。 |
十一、字体颜色和大小
在 Markdown 中本身没有直接设置字体颜色和大小的语法，但可以通过 HTML 标签来实现。不过这种方式可能在不同的 Markdown 渲染环境中表现不一致。
例如，设置红色字体：<font color= red>这是红色字体。
效果：这是红色字体
<font color=palegoldenrod> 苍麒麟色
<font color=palegreen> 苍绿色
<font color=palevioletred> 苍紫罗蓝色
<font color=peachpuff> 桃色
<font color=papayawhip> 番木色
<font color=pink> 粉红
<font color=plum> 杨李色
<font color=powderblue> 粉蓝色
<font color=purple>紫色
<font color=rosybrown> 褐玫瑰红
<font color=rubine> 宝石红
<font color=saddlebrown> 重褐色
<font color=salmon> 鲜肉色
<font color=sandybrown>沙褐色
<font color=sapphire> 宝石蓝
<font color=scarlet> 猩红色
<font color=seagreent> 海绿色
<font color=seashell >海贝色
<font color=sienna> 赭色
<font color=silver > 银白色
<font color=skyblue> 天蓝色
<font color=slateblue > 石蓝色
<font color=slategray >灰石色
<font color=smokygray> 烟灰色
<font color=snow >雪白色
<font color=springgreen >春绿色
<font color=steelblue >钢蓝色
<font color=tomato >番茄色
<font color=slateblue > 翠蓝色
也可以使用十六进制颜色值
例如red用十六进制颜色值表示为#FF0000，黑色就是#000000,blue为#0000FF。
设置字体大小为5号：<font size=8>这是5号字体。
效果：这是5号字体
后面加上 < /font> 控制范围结束
设置字体为楷体<font face="楷体" >这是楷体
效果：这是楷体
十二、数学公式
CSDN Markdown 编辑器支持 LaTeX 语法来插入数学公式。
- 行内公式：使用单个
$包裹公式。例如： E = m c 2 E = mc^2 E=mc2。 - 独立公式：使用两个
$$包裹公式。例如：
F = m a F = ma F=ma
十三、待办事项列表
使用 - [ ] 表示未完成的事项，使用 - [x] 表示已完成的事项。例如：
- 任务一
- 任务二
十四、脚注
可以使用脚注来为文档中的特定内容添加注释。
例如：这是一个需要注释的内容1。
然后在文档的任意位置添加脚注的定义：
十五、目录
在文档的开头可以使用 [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 编辑器提供了丰富的语法和功能，让用户能够轻松地创建格式规范、内容丰富的文档。通过掌握这些语法和功能，用户可以提高文档的质量和可读性，更好地分享知识和经验。同时，也要注意兼容性、简洁性、安全性等问题，以确保文档的质量和可靠性。
这是脚注的内容 我是注释。 ↩︎
