markdown基本语法和GFM语法
目录
作者: 圆弧兄弟
mail: Zheng_yuanhu@163.com
摘要:
1. 介绍markdown基本语法,包括标题、加粗、斜体、列表、引用、链接、图片、删除线、代码块、分割线的相关用法。
2. 介绍markdown的常用扩展语法GFM,包括表格、任务列表、锚点、数学公式、表情、diff语法。其中,GFM全称为GitHub Flavored Markdown,是GitHub扩展的markdown语法。
markdown简介
- markdown是一种标记语言,通过一些标记使文本具有格式。
- 使用Typora作为markdown编辑器,Typora和VScode是目前最好用的markdown编辑器,Typora相对简洁。
- markdown常用于写博客、邮件、微信工作号、github项目简介,甚至可以用于写ppt、流程图等等。
基本语法
标题
1. #紧接一个空格,再加文字。
2. #代表一号标题,##代表二号标题,最多支持6号标题。
加粗
1. **加粗内容**
效果:加粗内容
斜体
1. *斜体内容*
效果:斜体内容
列表
1. 有序列表以1.紧接一个空格开始。
2. 无序列表以+/-/*紧接一个空格开始。
效果:
- 有序列表
- 无序列表
引用
1. >紧接一个空格,再加文字。
2. 可以内嵌[加粗]、[斜体]、内嵌引用和列表等。
效果:
内嵌加粗和斜体
内嵌引用
- 内嵌列表
链接
1. 普通链接:[链接别名](链接内容),如[我的github](https://github.com/uncle-yohu/)。
2. 引用链接:在使用处写[名字][链接标记],在文末使用 [链接标记]:链接地址 来定义一个链接,链接地址必须以http://或https://开头。如[我的github][别名]和[别名]:https://github.com/uncle-yohu/。
3. 网址链接:使用<>来包裹邮箱或网址,自动成为一个超链接。
效果:
普通链接或引用链接:我的github
网址链接:https://github.com/uncle-yohu/
图片
1. 。
2. ,如。
3. 注意:在个人博客上,本地图片是显示不出来的,必须上传为网络图片才能显示。
效果:
删除线
1. ~~删除线~~
效果:删除线
代码块
1. ```开头,```结尾,这种方式可选择语言类型,比如shell……。
2. 单行代码块,`开头,`结尾。
3. 多行代码块使用4个空格或tab开头,这种不能选择语言,推荐使用前两种。
4. 代码块中所有的标记不会被转义,原样展示。
效果:cd ~
cd /
rm -rf *
分割线
1. ----(常用)
2. ****
3. ___
效果:博客园不支持分割线,无法展示。
GFM语法
表格
1. 以|分割一列,如|左对齐|右对齐|居中对齐|。
2. 表头和内容之间用------分割,同时:表示左对齐,-:表示右对齐,:-:表示居中对齐。
3. 可以使用斜体、粗体、删除线、链接等。
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
左对齐粗体 | 右对齐斜体 |
任务列表
1. -空格[空格]空格,表示未完成的任务列表。
2. -空格[x]空格,表示已完成的任务列表。
3. 可以使用斜体、粗体、删除线、链接等。
-
[ ] 表示未完成的任务列表
-
[x]
表示已完成的任务列表
锚点
1. 用于跳转到某个标题,可以用于制作目录。
2. [描述](#锚点名)
数学公式
1. $$+换行+数学公式+换行+$$,如:
$$
E=mc*(x)^w/2
$$
\[E=mc*(x)^w/2 \]
表情
1. 参考https://www.webfx.com/tools/emoji-cheat-sheet网站上的emoji代号
2. :表情代号:,代表一个表情,如:smile:。
diff语法
1. 支持git版本控制工具中,对代码进行高亮,如:
+ rm -rf ./*
- rm -rf /*
2. 在```之后写diff
+ rm -rf ./*
- rm -rf /*