说明
本科的时候郭江凌老师用Markdown写过编程课件和程序说明等,但我生性懒惰,当时没能掌握这门标记语言。这些天心血来潮,想在CSDN上发博客,编辑语法就是Markdown,于是花了一天的时间了解了这门语言,顺带就将Markdown基本语法作为我的处女文章发表了。
1、标题
说明: 使用#号可表示1-6级标题,一级标题对应一个#号,二级标题对应两个#号,以此类推。注意#号后要加一个空格。
例:
# 论文题目
## 3 对比实验
### 3.1 A方法
### 3.2 B方法
### 3.3 结果及分析
效果:
论文题目
3 对比实验
3.1 A方法
3.2 B方法
3.3 结果及分析
2、字体
说明: 左右1个*斜体,左右2个*粗体,左右3个*粗斜体,左右两个=高亮。
例:
*斜体文本*
**粗体文本**
***粗斜体文本***
==高亮文本==
效果:
斜体文本
粗体文本
粗斜体文本
高亮文本
3、分割线
说明: 在一行中用≥3个的-号来建立一个分隔线,-号之间间隔一个空格,行内不能有其他内容。
例:
- - -
内容
- - -
效果:
内容
4、删除线
说明: 在文字的左右两端加上两个波浪线~~。
例:
~~带删除线文本~~
效果:
带删除线文本
5、下划线
说明: 在文字的左右两端加上HTML的<u>标签。
例:
<u>带下划线文本</u>
效果:
带下划线文本
6、注解
6.1 脚注
说明: [^脚注名],脚注是对文本的补充说明,说明的文本出现在文章末尾。
[^脚注名]: 说明性文字。
例:
Zhao等[^XYZ]提出了
[^XYZ]: 参考文献
效果:
Zhao等1提出了
6.2 注释
说明:*[需要说明的文本], 注释也是补充说明,但是说明的文本出现在鼠标悬停的时候。注意在需要说明的文本前加空格,以区分普通文本。
例:
Markdown将文本转换为 HTML。
*[HTML]: 超文本标记语言
效果:
Markdown将文本转换为 HTML。
7、列表
7.1 无序列表
说明: -作为列表标记,标记后面要加一个空格,然后再填写内容。
例:
- 第一项
- 第二项
- 第三项
效果:
- 第一项
- 第二项
- 第三项
7.2 有序列表
说明: 数字加上.号,加一个空格,然后再填写内容。
例:
- 第一项
- 第二项
- 第三项
效果:
- 第一项
- 第二项
- 第三项
7.3 任务列表
说明: -加空格,[]内加空格,加空格后加任务名称表示未完成;[]内加x或X表示已完成。
例:
- [ ] 未完成
- [x] 已完成
效果:
- 未完成
- 已完成
7.4 自定义列表
说明: 冒号后接空格能实现列表前无符号。
例:
Authors
: John
: Luke
效果:
-
Authors
- John
- Luke
8、区块
说明: 在段落开头使用>符号,然后加一个空格。另外区块是可以嵌套的,一个>符号是第一层,两个>符号是第二层,以此类推。
例:
> 第一层
> > 第二层
> > > 第三层
效果:
第一层
第二层
第三层
9、列表嵌套
说明: 在子列表中的选项前面添加一个Tab能够实现列表嵌列表,列表嵌区块。
例:
- 第一项:
* 子列表1
* 子列表2 - 第二项:
> 区块1
> 区块2
效果:
- 第一项:
- 子列表1
- 子列表2
- 第二项:
区块1
区块2
10、超链接
10.1 初级链接
说明: [链接名称](链接地址)或<链接地址>,前者点链接名称跳转,后者直接点链接地址跳转。链接需要注意链接地址不包含协议名称是无法跳转链接的,<www.baidu.com>是无效的。
例:
详情可见[百度一下](https://www.baidu.com)或<https://www.bing.com>
效果:
详情可见百度一下或https://www.bing.com
10.2 高级链接
说明: 通过变量来设置链接,变量赋值在文章结尾进行。适用于长文章,类似于论文的参考文献集中在后面处理。
例:
遇到不懂的问题可以[bing][1]或者[Baidu][2]
(至少空一行表示文章结尾)
[1]: http://www.bing.com/
[2]: http://www.baidu.com/
10.3 本地链接
说明: [链接名称](#标题名),可以跳转到标题名的地方,注意#和标题名之间无空格,标题名不能出现标点符号和空格。
例:
此处参考[说明](#说明)
效果:
此处参考说明
Note:此处点击“说明”理应跳转到本文开头的说明处(已在VSCode下验证成功),CSDN的编辑器貌似不行。
11、图片
说明:![文本](图片地址 “可选标题”),有可选标题的话鼠标悬停会出现说明,图片地址除了网址外,也可以用本地地址,但不支持绝对路径,只能用相对路径。
例:
[一筐猪](https://i-blog.csdnimg.cn/blog_migrate/300609863c27a8afa47ba38cadc7ea79.jpeg"一筐猪")
效果:
12、表格
说明: 用|来分隔不同的单元格,用-来分隔表头和其他行,单元格内的空格无效,为了便于观察还是加几个空格比较好。
对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
例:
| 姓名 | 性别 | 年龄 |
| :---- | :----: | ----: |
| 张三 | 男 | 20 |
| 李四 | 女 | 30 |
效果:
姓名 | 性别 | 年龄 |
---|---|---|
张三 | 男 | 20 |
李四 | 女 | 30 |
13、代码
说明: 左右一个反引号`表示特定函数或变量;左右三个反引号`后可以指定语言(非强制)表示代码块。
例:
`main`函数
```c
# include <stdio.h>
int main()
{
printf(“Hello world!”\n);
return(0)
}
```
效果:
main
函数
# include <stdio.h>
int main()
{
printf("Hello world!"\n);
return(0)
}
14、转义
说明: 反斜杠 + 转义特殊字符,能回归字符原本的格式。
例:
\* 或 \#
效果:
* 或 #
15、其他
其他高阶语法比较复杂(流程图,甘特图,LaTeX公式等),个人认为Markdown的优势在于对文本沉浸式地编辑,高阶语法削弱了这点(LaTeX除外,公式还是比较有用的),以上内容足以满足需求。
本文参考资料:
书籍:《了不起的Markdown》
网站:菜鸟教程
视频:B站视频-8分钟让你快速掌握Markdown
参考文献 ↩︎