Markdown基本语法

说明

本科的时候郭江凌老师用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 有序列表

说明: 数字加上.号,加一个空格,然后再填写内容。


例:

  1. 第一项
  2. 第二项
  3. 第三项

效果:

  1. 第一项
  2. 第二项
  3. 第三项

7.3 任务列表

说明: -加空格,[]内加空格,加空格后加任务名称表示未完成;[]内加x或X表示已完成。


例:
- [ ] 未完成
- [x] 已完成


效果:

  • 未完成
  • 已完成

7.4 自定义列表

说明: 冒号后接空格能实现列表前无符号。


例:

Authors
: John
: Luke


效果:

Authors
John
Luke

8、区块

说明: 在段落开头使用>符号,然后加一个空格。另外区块是可以嵌套的,一个>符号是第一层,两个>符号是第二层,以此类推。


例:
> 第一层
> > 第二层
> > > 第三层


效果:

第一层

第二层

第三层


9、列表嵌套

说明: 在子列表中的选项前面添加一个Tab能够实现列表嵌列表,列表嵌区块。


例:

  1. 第一项:
    * 子列表1
    * 子列表2
  2. 第二项:
    > 区块1
    > 区块2

效果:

  1. 第一项:
    • 子列表1
    • 子列表2
  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


  1. 参考文献 ↩︎

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

一筐猪呀

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值