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

一、标题

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

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

二、段落

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

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

例如:这是第一个段落。

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

三、强调

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

四、列表

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

五、链接

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

六、图片

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

七、引用

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

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

八、代码块

  1. 行内代码:用反引号``包裹。如:这是行内代码。行内代码用于在文本中插入少量的代码片段,强调特定的代码部分,与周围的文本区分开来。
  2. 代码块:用三个反引号包裹,并在开头反引号后指定代码语言(可选)。例如:
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 语法来插入数学公式。

  1. 行内公式:使用单个 $ 包裹公式。例如: E = m c 2 E = mc^2 E=mc2
  2. 独立公式:使用两个 $$ 包裹公式。例如:
    F = m a F = ma F=ma

十三、待办事项列表

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

  • 任务一
  • 任务二

十四、脚注

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

例如:这是一个需要注释的内容1

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

十五、目录

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

十六、高级用法

  1. 嵌套列表和引用:可以在列表项中嵌套列表和引用,以创建更复杂的文档结构。

    • 例如:
    • 第一项
      • 子项一
      • 子项二
    • 第二项

      引用内容

  2. 链接和图片的组合:可以在链接中插入图片,以创建更丰富的链接效果。

    • 例如:[这是一个链接,包含一张图片](https://example.com/image.jpg)
  3. 代码块中的注释:在代码块中可以使用注释来解释代码的功能和实现方法。

    • 例如:
# 这是一个注释
print("Hello, World!")
  1. 表格的高级样式:可以使用 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>

十七、注意事项

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

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


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

点赞(0) 打赏

评论列表 共有 0 条评论

暂无评论

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部