Written with StackEdit中文版.

Markdown简介

Markdown是一种轻量级的标记语言，通过使用简单的标记符号，将纯文本转换成格式丰富的HTML文档。

Markdown语法

Markdown的语法相对简单直观，通过标签来实现块级元素和行内元素的效果。注意，部分标记后面需要带空格，否则不生效

块级元素

是指占据一整行或多行的元素，常用于格式化文本的结构和布局，如段落、标题、列表等。

标题

通过1~6个”#”来控制标题字体的大小，并且字体自带加粗效果，如：

  • 标题「Markdown语法」用了2个#
  • 标题「块级元素」用了3个#

即#的数量越少，标题越大；越多，标题越小。

引用文本

在文本的前面加”> “来实现，效果如下：

这里是一个引用文本
~
~
~

有序列表

在文本前面加“1. ”来实现，在StackEdit编辑Markdown时换行时会自动补充序号，效果如下：

  1. 起床
  2. 刷牙
  3. 洗脸

无序列表

在文本前面加”- “来实现，效果如下：

  • 吃饭
  • 睡觉
  • 玩游戏

复选框

在文本前面加”- [ ] “来实现，实现如下：

1
2
3
- [ ] 学习C语言
- [ ] 学习Python
- [ ] 学习Java

代码块

以3个反引号“`”开头，后面加代码语言类型，换行后写对应类型的代码，最后换行以3个反引号结尾，效果如下：

C语言
1
2
3
int main(void){
	return 0;
}
Java
1
2
3
public static void main(String[] args){
	System.out.println("Hello Java!");
}
Python
1
2
if __name__ == "__main__":
	print("Hello Python")
SQL
1
select * from xxx where id > 10 group by xxx having count(xxx) > 10 order by xxx desc;

数学公式

在两个双”$”号之间用KaTeX语法写对应的数学公式，实现如下：

1
2
3
$$
\frac{\partial f}{\partial x}=2\sqrt{a}x
$$

表格

表头

以”|”号开头和结尾，表的字段名也用”|”号分隔

设置属性的对齐方式

类似表头的格式，把字段名换成两个”-“号，在两个”-“号的两边通过添加”:”号来设置属性的对齐格式：

  • 只填左边表示左对齐
  • 只填右边表示右对齐
  • 两边都填表示居中
    属性
    类似表头的格式，直接填相应的属性即可

    综上，设置一个姓名左对齐、性别居中、爱好右对齐的表的效果如下：
姓名性别爱好
张三男跑步
狗蛋儿未知打篮球

实现如下：

1
2
3
4
|姓名|性别|爱好|
|:--|:--:|--:|
|张三|男|跑步|
|狗蛋儿|未知|打篮球|

脚注

在文本后面添加[^脚注名]，并在段落后面换行时将所添加的符号用”:”做解释，效果如下：

一键三连三连 的效果我们都知道，是对up主最大支持和赞赏，因此三连多多，佳作连连。

脚注的内容会自动放在文章底部，注意解释之后必须换行才能继续写下一个段落，否则会被视为脚注解释内容

分割线

以三个”-“号作为一行，其中上面的一级、二级标题和脚注解释会自动生成分割线，效果如下：

链接

直接添加

以[1](2 3)的形式出现，其中

  • 1填链接的文本
  • 2填链接
  • 3填鼠标放在链接上的提示文本

效果如下：
百度

实现如下：
[百度](https://www.baidu.com "百度一下，你就知道")

引用添加

以”[1][2]”和”[2]: “的形式出现，其中

  • 1填链接的文本
  • 第一个2填自定义的id名
  • 第二个2的空格后面填链接 提示文本 注意链接和提示文本存在空格

实现如下：

1
2
[百度][a]
[a]: https://www.baidu.com “百度一下，你就知道”

添加图片

类似链接的直接添加形式，在前面加“!”号，链接改为图片的图床链接或本地连接即可实现，效果如下：
百度
实现如下：

1
![百度](https://www.baidu.com/img/bd_logo1.png?where=super "百度搜索logo")

行内元素

是指在一行内显示的元素，常用于格式化文本的样式，如加粗、斜体、链接等。

斜体

文本两边加”*”号实现，效果如下：

斜体内容

加粗

文本两边加”**”实现，效果如下：

被加粗的文字

代码

文本两边加反引号实现，效果如下：
print("Hello World!")

删除线

文本两边加“~~”实现，效果如下：

被删除的内容

表情

以”&#x对应表情的字符编码;”出现在文本中，如
😀表示一个笑脸😀,其他表情的字符编码的参考网站

在Markdown中的Html代码

除了Markdown的基本语法，还可以使用HTML标签实现更多功能，但应当根据具体的Markdown解析器和使用场景来决定是否支持和如何解析HTML标签。

嵌入学习参考的Bilibili视频：

实现代码：

1
<iframe src="//player.bilibili.com/player.html?aid=327623069&bvid=BV1JA411h7Gw&cid=171385214&p=1&autoplay=0" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" > </iframe>

注意src后面需要加上&autoplay=0让视频不会自动播放，否则容易被吓一跳

最后

以上内容基本是在参考学习的视频中学到的，包括视频嵌入代码的获取方式，文字描述枯燥，视频会更加直观易懂。