Markdown语法详解

Posted 2021-12-03 coco椰果

 

Markdown是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。

1. Vscode安装Markdown

Vscode的插件市场中，搜索Markdown关键字，安装这两个插件

第一个插件，是一个组合包，会把最常用的Markdown优化都装好；第二个插件，则是Github使用的Markdown渲染样式.

 

 

 在VsCode创建以md结尾的文件，点击文件右上角的这个图标，页面会变成两栏分列的样子；右侧这一栏就是markdown文件被渲染为HTML的预览.

2. 语法详解

2.1. 标题

1. 使用 = 和 - 标记一级和二级标题

• 示例

一级标题
==
 
二级标题
--

• 效果

 

2. 使用 # 号标记

• 示例

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

• 效果

 

2.2. 字体

• 加粗

要加粗的文字左右分别用两个*号包起来

• 斜体

要倾斜的文字左右分别用一个*号包起来

• 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

• 删除线

要加删除线的文字左右分别用两个~~号包起来

示例:

**这是加粗的文字**    
*这是倾斜的文字*   
***这是斜体加粗的文字***  
~~这是加删除线的文字~~

效果：

2.3. 引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>

• 示例：

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

• 效果：　　

2.4. 分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

•  示例：

* * *
​
***
​
*****
​
- - -
​
-------------------------------

• 效果：

2.5. 图片

• 语法：

![图片alt](图片地址 "图片title")

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。 图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加　　

• 示例：

![刘诗诗](https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.9ku.com%2Fpic%2Fgsxc%2F8%2F70881114.jpg&refer=http%3A%2F%2Fimg.9ku.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1618651736&t=a6c62a772c754e6562548a6845323f90 "刘诗诗")

• 效果：　　

2.6. 超链接

• 语法：

[超链接名](超链接地址 "超链接title")

title可加可不加

• 示例：

[百度](http://baidu.com) 
 
[google](http://google.com  "Google")

•  效果：

2.7. 列表

 无序列表

无序列表用 - + * 任何一种都可以

- + * 跟内容之间都要有一个空格

•  示例：

- 列表内容
+ 列表内容
* 列表内容

• 效果：

有序列表

• 示例：

1. 列表内容
2. 列表内容
3. 列表内容

• 效果：

列表嵌套

上一级和下一级之间敲三个空格即可

• 示例：

* 一级无序列表内容
  * 二级无序列表内容
1. 一级有序列表内容
   1. 二级有序列表内容 
   * 二级无序列表内容

• 效果：

 任务列表

用半形方括号创建个任务列表：

• 示例：

- [ ] 第一条
- [ ] 第二条
- [x] 完成的条目

• 效果

2.8. 表格

• 示例：

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

- 有一个就行，为了对齐，多加了几个

文字默认居左

-两边加：表示文字居中

-右边加：表示文字居右

• 效果：

2.9. 代码

单行代码：代码之间分别用一个反引号包起来

• 示例：

`create database hero;`

• 效果：

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行

• 示例：

```
package main
import "fmt"
func main() {
    fmt.Println("Hello, 世界")
}
```

• 效果

 要添加语法高亮显示，请在代码块开始的```之后键入要高亮显示的语言

支持的语言有：

as, applescript, osascript, scpt, bash, sh, zsh, clj, boot, cl2, cljc, cljs, cljs.hl, cljscm, cljx, hic, coffee, _coffee, cake, cjsx, cson, iced, cpp, c, cc, h, c++, h++, hpp, cs, csharp, css, d, di, dart, delphi, dpr, dfm, pas, pascal, freepascal, lazarus, lpr, lfm, diff, django, jinja, dockerfile, docker, erl, fortran, fsharp, fs, gcode, nc, go, groovy, handlebars, hbs, html.hbs, html.handlebars, hs, hx, java, jsp, js, jsx, json, jl, kt, ktm, kts, less, lisp, lua, mk, mak, md, mkdown, mkd, matlab, m, mm, objc, obj-c, ml, perl, pl, php, php3, php4, php5, php6, ps, ps1, pp, py, gyp, r, ruby, rb, gemspec, podspec, thor, irb, rs, scala, scm, sld, scss, st, styl, sql, swift, tex, vbnet, vb, bas, vbs, v, veo, xml, html, xhtml, rss, atom, xsl, plist, yaml

•  示例：

```go
package main
import "fmt"
func main() {
    fmt.Println("Hello, 世界")
}
```

• 效果

3. markdown软件推荐

• Typora：https://www.typora.io/