Markdown常用语法

Notes for markdown

Posted by Jin Xu on November 21, 2024

前言   

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。简洁、高效、易读、易写。同时,markdown也被Github等网站大量使用。

这个是markdown官方的在线编辑器。https://markdown.com.cn/editor/

1 Markdown基本语法      

1.1 标题语法  

写法1:

1
2
3
4
5
6
# 一级标题          或者用HTML语法:<h1>Heading level 1</h1>
## 二级标题         或者用HTML语法:<h2>Heading level 2</h2>
### 三级标题        ...
#### 四级标题       ...
##### 五级标题      ...
###### 六级标题     ...

写法2:

1
2
3
4
5
在标题的下面写任意数量的==或者--来表示一级标题或者二级标题
Heading level 1
===
Heading level 2
---

示例:

Heading level 1

Heading level 2

1.2 字体语法

1.2.1 粗体、斜体、删除线

1
2
3
4
*这里是文字*        #斜体     
**这里是文字**      #粗体  
***这里是文字***    #斜体+粗体    
~~这里是文字~~      #删除线  

这里是文字 #斜体     
这里是文字 #粗体      
这里是文字 #斜体+粗体    
这里是文字 #删除线      

1.2.2 字体、字号、颜色

这里,就需要用到HTML语法了。

因为它本身是不支持修改字体、字号与颜色等功能的。

有些网站,比如像Github、知乎、简书等,它们就无法设置这种功能。不过像有的网站,比如像CSDN,它的Markdown编辑器做了很好的扩展、支持HTML语法,就有这样的功能。

具体如下:

1
<font face='宋体' color=#0000FF size=4>我是正文</font>   

<font face=’宋体’ color=#0000FF size=4>我是正文</font>    

1.2.3 背景色

在markdown语法里,本身也是没有背景色这样一个选项的。

所以,就需要用内置HTML的形式。

借助 table, tr, td 等表格标签的 bgcolor 属性来实现背景色的功能。举例如下:

1
<table><tr><td bgcolor=orange>背景色是:orange</td></tr></table>
背景色是:orange

1.3 链接

1.3.1 Markdown语法

1
2
3
4
Markdown语法形式

[文本](链接) 
[百度一下,你就知道](https://www.baidu.com)

百度一下,你就知道

1
2
3
4
给链接加一个备注
就是把你的鼠标放到该链接上时,会显示出来的文字。
直接在圆括号后面添加即可,就像这样:
[百度一下,你就知道](https://www.baidu.com "这是一个搜索网站") 

百度一下,你就知道

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 给图片添加链接     

![图片解释性内容](图片链接)
      
## ![北京大学]:表示图片的 alt 文本 (当图片无法加载时显示的文字)。  
## 图片链接:直接指向图片的 URL 地址。 


# 把图片变成超链接  
[![北京大学](相关图片链接)](跳转链接)

# 自动生成超链接,邮箱,图片……  
## 直接在链接的两侧加上一个尖括号,这样markdown会自动将其识别为一个链接。
<[email protected]>   

北京大学

[email protected]  

1.3.2 html语法     

1
2
3
4
# 出来的效果和上面的是一样的。
<img src="图片链接" alt="图片alt" title="图片title">

<a href="超链接地址" title="超链接title">超链接显示名</a>  
1
2
3
4
# 图片跳转新标签页打开
<a href="跳转地址" target="_blank">
  <img src="图片来源" alt="加载失败显示的文字">
</a>

示例 北京大学

1.4 引用     

1.4.1 锚点

锚点实际上就是页内连接。具体语法是:

1
2
3
## 这是我的标题{#index}   //在某个标题后面设置锚点

跳转到[目录](#index)		//回到锚点

跳转到前言                 

1.4.2 注脚

1
2
3
xxxx[^1]xxxxx

[^1]:xxxxx

北京大学是TOP11

1.4.3 内容目录 

1
2
3
4
5
[TOC]

# 一级标题
## 二级标题
### 三级标题

对于不支持 [TOC] 的平台,可以手动编写目录:

1
2
3
4
5
6
7
8
9
10
11
12
13
# 目录
- [一级标题](#一级标题)
  - [二级标题](#二级标题)
    - [三级标题](#三级标题)

# 一级标题
内容...

## 二级标题
内容...

### 三级标题
内容...
  1. 北京大学No1