markdown 基本用法

Posted 2021-01-13 assaltyfish

一、markdown 简介

markdown 是一种轻量级的标注语言，可以以纯文本的格式编写文档，也容易将文档转换成有效的Xhtml或HTML。

二、markdown语法

2.1 段落与换行

• 【段落】
  　　前后必须是空行（空白或者制表符等）
  　　相邻的两行文本如果中间没有空行会显示在同一行

• 【换行】
  　　段落内部的换行需要在行尾加入至少两个空格

2.2 标题

• 【一级标题】
  　　使用数个等号（=）或者一个#号

• 【二级标题】
  　　使用数个短线（-）或者两个#号

• 【三到六级标题】
  　　使用相对应数目的#号

• 【格式规定】
  　　标题中左右两侧都可以加入#号
  　　标题两侧的空白字符不显示，中间的空白字符显示

2.3 引用

• 【单行引用】
  　　每行前面加入一个大于号（>）

  单行引用的例子

• 【多行引用】
  　　在每行前面加入一个大于号（>）
  　　如果引用多个空行，默认为引用会合并

  多行引用，含有大于号
  一下是四个空行，最终的显示合并为一个空行

  多行引用

  以上的内容是一个空行产生的空白

• 【嵌套引用】
  　　引用之中可以加入引用，在行的前面加入两个大于号
  　　嵌套引用的两个大于号和一个大于号之间应该加入一个空的引用

  嵌套引用，两个大于号
  第一个嵌套引用

  中间有一个空的引用

  第二个嵌套引用

2.4 列表

• 【无序列表】
  　　使用+ - * 都可以表示列表
  • 乘号*表示列表
  • 减号-表示列表
  • 加号+表示列表

• 【有序列表】
  　　暂时没有找到合适的方法，可以使用HTML语言直接写
  　　有序列表<ol> <li> </li> </ol>
  　　※ 不建议这么做
  

  
  
  1. 有序列表第一项
  
  
  2. 有序列表第二项
  
  
  3. 有序列表第三项
  
  

• 【嵌套列表】
  　　无序列表和有序列表可以互相嵌套

2.5 代码

• 【代码块】
  　　前后需要至少一个空行，且每行代码前需要至少一个或四个空格
  　　代码之间的空行最好是1行，否则视作两个代码块

  code 代码块开始
  
  code 代码块结束

• 【行内代码】
  　　通过反引号（`）英文输入法下tab键上面的键
  　　如code,这种情况一般表示按键Enter

2.6 分割线

　　一行中使用三个或更多的* - _ 来添加分隔线
　　多个字符之间可以有空格但不能有其他字符

---

---

2.7 超链接

• 【行内链接】
  　　格式
  link text
  注：title text 可以使用单引号，也可使用双引号 ，是鼠标放上去显示的文字
  　　绝对路径链接，如：
  google
  　　相对路径链接，如：
  img.png
  　　包含标题的链接，如：
  google

• 【参考式】
  可以将内容先卸载别的地方