目录
前言
Markdown 是一种轻量级标记语言,排版语法简洁,初衷是让人们更多地关注内容本身而非排版。可与HTML混编,可导出 HTML、PDF 以及 .md 后缀格式的文件。
Markdown有基础语法与扩展语法之分,扩展语法是基础语法的超集,以适应更加复杂的需求。扩展语法不一定能被所有Markdown编辑器所兼容。CSDN实现了Markdown编辑器,并拓展了一些新的样式,也一并介绍。
本文参考Markdown 官方教程撰写👍。
标题语法
# title1 // 一级标题
## title2 // 二级标题
#
与标题之间填充空格,#
的个数决定标题的级数。
分割线语法
--- // 分割线
为了兼容不同的编辑器,注意前后各空一行。
段落语法
分段
段与段之间空一行,类似于Latex。
换行
空两格回车(CSDN中貌似直接回车即可),或使用HTML语法中的<br>
标签。
缩进
空格与制表符都无法实现缩进,这与Word之类的富文本编辑器不同。
通过HTML语法可以实现缩进
   // 表示添加一个tab位置
效果为
Hello world
或可以尝试使用自定义列表实现缩进,该语法为扩展语法。语法为
首行
: 缩进1 // 缩进
: 缩进2
效果为
-
首行
- 缩进1
- 缩进2
强调文本
粗体
效果为 Bold
**Bold** // 加粗
等效HTML语法为<b>
标签
<b>Bold</b>
斜体
*Italic* // 斜体
效果为 Italic
粗体&斜体
***text*** // 粗体&斜体
效果为 text
高亮(CSDN)
在CSDN中可以使用该语法
==Highlight== // 高亮
效果为 Highlight
删除线(扩展语法)
~~delete~~ // 删除线
效果为 delete
上下标(CSDN)
在CSDN中可以使用该语法
H~2~O // 下标
2^10^ // 上标
效果为:H2O、210
超链接
title
可选,悬停显示。
[添加链接描述](url "title")
这是通向GitHub的链接。
网页&邮箱
<url>
这是通向 http://baidu.com 的链接。
引用语法
>quote // 引用
效果为
quote
引用嵌套
>quote // 引用
>>quote
效果为
quote
quote
参考文献引用(扩展语法)
即脚注。
效果见文末^[foot] // 脚注
效果见文末1
列表语法
有序列表
1. xxx // 有序列表
2. xxx
效果为
- xxx
- xxx
无序列表
- xxx // 无序列表
- xxx
效果为
- xxx
- xxx
任务列表(扩展语法)
- [ ] List item // 待选
- [x] List item // 已选
效果为
- List item
- List item
列表嵌套
- xxx // 列表嵌套
1. xxx
效果为
- xxx
- xxx
代码语法
单行代码
效果为code
`code` // 单行代码
等效为HTML中的<code>
标签
<code>code</code>
代码块(扩展语法)
```python
print("Hello World!")
```
支持语法高亮,效果为
print("Hello World!")
表格语法(扩展语法)
使用3个以上连字符---
创建每列的标题,并使用管道|
分隔每列。CSDN中2个以上连字符--
即可。
| 1 | 2 | 3 |
|---|---|---|
| a | b | c |
效果为
c1 | c2 | c3 |
---|---|---|
a | b | c |
表格中可以实现文本强调、代码以及超链接。不能解析标题,引用,列表,图像或HTML标签。
文本对齐
默认居中对齐,左对齐:--
,居中:--:
,右对齐--:
。效果为
c1 | c2 | c3 |
---|---|---|
a | b | c |
图片语法
![图片无法正常显示时的显示文本](url "title")
例如,当图片的 url 无法正确解析时,效果为
title
为鼠标悬停在图片上显示的文本,效果为
插入emoji表情(扩展语法)
更多emoji表情简码见GitHub 表情符号简码列表
:tent:
:+1:
效果为
⛺️
👍
图片超链接
实际就是嵌套了一层超链接
[![图片无法正常显示时的显示文本](url "title")](url "title")
公式语法(KaTeX)
CSDN中支持KaTeX内嵌公式,语法与LaTeX基本一致。
$公式$ // 行内插入
$$公式块$$ // 代码块
其余语法详见LaTeX。
效果为:
a
+
b
=
c
a+b=c
a+b=c
x
3
3
+
1
=
2
\frac{x^{3}}{3}+1=2
3x3+1=2
foot ↩︎