markdown常用的基本语法

发布时间 2023-03-31 22:14:31作者: hiibird

标题

markdown通过在文本前加"#",将后续文本设置为标题,几个"#"就代表几级标题。
例如"## 二级标题"的效果为:

二级标题

"### 三级标题"的效果为:

三级标题

字体

markdown通过在文本前后添加"*""~"等符号实现不同的文本效果。
例如,文本前后各加一个"*"为斜体,两个"*"为粗体,三个"*"为斜体加粗
文本前后各加两个"~"为废弃线

引用

markdown通过使用">"来启用引用格式

这世界上本没有路,走的人多了,也便有了路。 --鲁迅

分割线

合理运用分割线可以使排版更加美观,更具可读性。markdown在单行内使用"***"或"---"来添加分割线,以下是分割线示例:


图片

markdown在文本中插入图片的方式为"![图片名称](图片路径)",其中图片链接可以是本地路径,也可以是网络链接。添加本地图片时,当该markdown文件转移时,图片本地路径会失效,因此一般将图片与markdown文件存放在同一个文件夹中,通过相对路径访问,转移文件时,直接转移整个文件夹。网络链接可以在跨设备转移时,不需要连同本地的图片一起转移,灵活性比较高。

超链接

markdown插入超链接的方式为"[链接名称](链接)",例如"[我的博客](https://www.cnblogs.com/hiibird/)"的效果为:我的博客

列表

有序列表

有序列表直接通过"1. XXX"直接开启,换行时一般会自动接续,通过在新一行直接再回车一次结束列表。
例如,"1. 第一行"...:

  1. 第一行
  2. 第二行
  3. ...

无序列表

无序列表直接通过"-"开启,结束方式同上。
例如,"- 第一行"...:

  • 第一行
  • 第二行

表格

表格略微麻烦,需要手动完成表格样式:

|name|gender|age|
|--|--|--|
|jack|male|18|

最终样式为:

name gender age
jack male 18

表格中每一行的列数要对其,最重要的是第二行的表头分隔符"|--|--|--|",只有添加了表头分隔符,以上代码才会被识别为表格。不过一般可以通过编辑器快捷添加,更加直观易用。

代码块

代码块通过"```"符号添加,该符号由esc键下的波浪号键,在英文输入(半角)状态下输入,以"```"结尾,可以通过在第一个标识符后添加"java""python"等指定改代码块的语言规则。如"```java ```",其中的语法高亮等均遵守Java编程规范:

public class Test{
	public static void main(String[] args){
	System.out.println("Hello World!");
	}
}