Markdown基础语法总结
Markdown基础语法总结
Markdown是一种轻量级标记语言,排版语法简洁,初衷是让人们更多地关注内容本身而非排版。本文将详细介绍Markdown的基础语法和扩展语法,帮助读者快速掌握Markdown的使用方法。
前言
Markdown是一种轻量级标记语言,排版语法简洁,初衷是让人们更多地关注内容本身而非排版。可与HTML混编,可导出HTML、PDF以及.md后缀格式的文件。
Markdown有基础语法与扩展语法之分,扩展语法是基础语法的超集,以适应更加复杂的需求。扩展语法不一定能被所有Markdown编辑器所兼容。
本文参考Markdown官方教程撰写。
标题语法
# title1 // 一级标题
## title2 // 二级标题
与标题之间填充空格,#的个数决定标题的级数。
分割线语法
---
为了兼容不同的编辑器,注意前后各空一行。
段落语法
分段
段与段之间空一行,类似于Latex。
换行
空两格回车(CSDN中貌似直接回车即可),或使用HTML语法中的<br>
标签。
缩进
空格与制表符都无法实现缩进,这与Word之类的富文本编辑器不同。通过HTML语法可以实现缩进
   // 表示添加一个tab位置
效果为
Hello world
或可以尝试使用自定义列表实现缩进,该语法为扩展语法。语法为
首行
: 缩进1 // 缩进
: 缩进2
效果为
首行
缩进1
缩进2
强调文本
粗体
效果为Bold
**Bold** // 加粗
等效HTML语法为
<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的链接。
页内跳转
实际是HTML语法,Markdown本身并不直接支持页面内跳转。
<!--在跳转的目标地点设置id,采用span标签-->
<span id="前言"/>
<!--在需要跳转的地方指定id-->
[跳转至前言](#前言)
跳转至前言
网页&邮箱
<url>
引用语法
>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>
代码块(扩展语法)
```python
print("Hello World!")
支持语法高亮,效果为
```python
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
为鼠标悬停在图片上显示的文本,效果为
插入emoji表情(扩展语法)
更多emoji表情简码见GitHub 表情符号简码列表
:tent:
:+1:
效果为
⛺️
👍
图片超链接
实际就是嵌套了一层超链接
[](url "title")
公式语法(KaTeX)
CSDN中支持KaTeX内嵌公式,语法与LaTeX基本一致。
$公式$ // 行内插入
$$公式块$$ // 代码块
其余语法详见LaTeX。
效果为:
a + b = c
a+b=ca+b=c
x 3 3 + 1 = 2
\frac{x^{3}}{3}+1=23x3 +1=2
- foot