Markdown语法详解


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, 世界")
}
```
  • 效果

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

支持的语言有:

asapplescriptosascriptscptbashshzshcljbootcl2cljccljscljs.hlcljscmcljxhiccoffee_coffeecakecjsxcsonicedcppccchc++h++hppcscsharpcssddidartdelphidprdfmpaspascalfreepascallazaruslprlfmdiffdjangojinjadockerfiledockererlfortranfsharpfsgcodencgogroovyhandlebarshbshtml.hbshtml.handlebarshshxjavajspjsjsxjsonjlktktmktslesslispluamkmakmdmkdownmkdmatlabmmmobjcobj-cmlperlplphpphp3php4php5php6psps1pppygyprrubyrbgemspecpodspecthorirbrsscalascmsldscssststylsqlswifttexvbnetvbbasvbsvveoxmlhtmlxhtmlrssatomxslplistyaml

  •  示例:
```go
package main
import "fmt"
func main() {
    fmt.Println("Hello, 世界")
}
```
  • 效果

3. markdown软件推荐

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