CSDN-markdown基本语法说明

最新推荐文章于 2025-04-07 20:19:09 发布

小敏纸

最新推荐文章于 2025-04-07 20:19:09 发布

阅读量1.8w

点赞数 24

分类专栏： Markdown CSDN-markdown使用指南文章标签： markdown 格式语法 html

本文链接：https://blog.csdn.net/lanxuezaipiao/article/details/44307757

版权

本文详细介绍了CSDN Markdown的基本语法，包括标题（Setext和atx形式）、区块引用、分隔线、强调、列表（无序和有序）、链接（自动链接和普通文本链接）、代码（行内代码和代码区块）以及反斜杠的用法。内容覆盖了Markdown的常用语法和CSDN编辑器的特色功能，旨在帮助用户更好地理解和使用Markdown进行文档编写。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

概述

简单介绍Markdown

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— 来自[维基百科]

简单的来说，Markdown就是用“标记符号”表示“格式”。Markdown语法标签与HTML语法标签是一一对应的，比如Markdown的二级标题标签##就对应着HTML中的<h2>...</h2>标记，而且Markdown是兼容HTML语法的，如果你比较喜欢 HTML 的 <a> 或 <img> 标签，可以直接在Markdown文档中使用这些标记，而不用 Markdown 提供的链接或是图像标签语法。

CSDN Markdown的功能支持

CSDN Markdown编辑器是使用StackEdit修改而来的，但在StackEdit的基础上做了一些细节优化，使得体验更加友好，CSDN Markdown支持的功能很多：

实时效果预览并自动滚动定位到编辑处（所见即所得）
支持 Markdown Extra / GitHub Flavored Markdown 扩展语法
支持代码语法高亮
支持 LaTeX 数学公式（基于 MathJax）
支持UML序列图和流程图
在线或离线管理多份 MarkDown 文档
支持离线编辑
支持导入在线和本地Markdown文档进行编辑
可以将编辑内容导出为 Markdown，HTML文件
管理已发布的文档

在这篇文章，我先介绍CSDN Markdown的基本语法，我会从Markdown语法说明、例子、与其对应的HTML语法、例子效果、注意事项这几个方面进行详细介绍。后面会继续介绍如何插入图片、CSDN Markdown的扩展语法、如何写数学公式和画图等相关的内容。

标题

Markdown 支持两种形式的标题语法：Setext形式和atx形式。

Setext 形式

Markdown语法说明：

Setext 形式是采用底线的方式，利用若干个 = （最高阶标题）和 - （第二阶标题）完成。

例子：

这是标题1
=============

这是标题2
-------------

对应的HTML语法：

<h1>这是标题1</h1>

<h2>这是标题2</h2>

效果：

这是标题1

这是标题2

注意事项：

这里#或-的数目是任意的，既可以写一个也可以写多个。

atx形式

Markdown语法说明：

atx 形式则是在行首插入 1 到 6 个 # ，分别对应到标题 1 到 6 阶。

例子：

# 这是标题1

## 这是标题2

### 这是标题3

#### 这是标题4

##### 这是标题5

###### 这是标题6

转化为HTML后分别对应<h1>...<h6>这6个标记。

效果：

这是标题1

这是标题2

这是标题3

这是标题4

这是标题5

这是标题6

注意事项：

Setext形式的标题只能表示标题1和标题2这两阶，而atx形式的标题可以表示标题1~标题6共6阶。

上面#与文本之间的空格不是必需的，不加也可以，但加上是个好的习惯。

你可以选择性地「闭合」atx样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上 #，而行尾的 # 数量也不用和开头一样（行首的#数量决定标题的阶数）。