Markdown快速入门教程

版权声明：本文为 Fly_liuhao 原创文章，非商用自由转载-保持署名-注明出处，谢谢！
本文网址：https://blog.youkuaiyun.com/Fly_1213/article/details/85263430

Markdown网站应用

• GitHub
• Gitee
• GitBook
• 优快云
• 简书
• 有道云笔记

Markdown编辑器工具

编辑器(软件)

• Typora
• Haroopad
• VsCode
• Atom
• Sublime Text

在线编辑

• Markable.in
• Dillinger.io
• 优快云
• 简书
• 有道云笔记

Markdown常用语法使用规则

1. 标题

• 通过 1 到 6 个 # ，对应到 1 到 6 级标题；
• 在一个文档中，尽量保证有且仅有一个一级标题；
• 标题应该按照顺序逐级递增，不要跨级；
• 标题名称不应该重复；
• 注意：【’#’ + ‘空格’ 】为正确格式；

  # 一级标题
  ## 二级标题
  ### 三级标题
  #### 四级标题
  ##### 五级标题
  ###### 六级标题
  

---

2. 区块引用 Blockquotes

• 区块引用使用类似 email 中用 > 的引用方式；
• 区块引用可以嵌套，只要根据层次加上不同数量的 >；
• 引用的区块内也可以使用其他 Markdown 语法；
• 注意：【’>’ + ‘空格’】为正确格式；

  > [RoboMaster机甲大师赛](https://www.robomaster.com/zh-CN)
  >> 机器人大赛
  >> 机器人夏令营
  >> 文化周边
  >> 论坛
  

  效果：

  RoboMaster机甲大师赛

  机器人大赛
  机器人夏令营
  文化周边
  论坛

  ---

3. 列表

• 无序列表使用 星号*、加号+ 或是 减号-(推荐) 作为列表标记；
• 有序列表则使用数字接着一个英文句点；
• 列表可以包含多个段落，每个项目下的段落都必须具备相同缩进；
• 注意：【‘1.’ + ‘空格’】或【’-’ + ‘空格’】为正确格式；

     - Red
       1. Dark Red
       2. Light Red
     - Green
       - Light Green
       - Dark Green
     - Blue
  

  效果：
  • Red
  1. Dark Red
  2. Light Red
  • Green
    • Light Green
    • Dark Green
  • Blue

---

4. 代码区块

• Markdown 会用 来把代码区块包起来;- Markdown 会用来把代码区块包起来;
• 建立代码区块时建议指定代码语言;

  代码块支持的语言

  ```java
  public static void main(String[] args){
      System.out.println("Hello World!");
  }
  ```(Java代码格式)
  

  ```python
  print('Hello','Python','World!')
  ```(Python代码格式)
  

  Java效果：

  public static void main(String[] args){
     System.out.println("Hello World!");
  }
  

  Python效果：

  print('Hello','Python','World!')
  

---

5. 分隔线

• 可以在一行中用三个以上的星号 * 建立一个分隔线;
• 可以在一行中用三个以上的负号 - 建立一个分隔线;
• 可以在一行中用三个以上的下划线 _ 建立一个分隔线;

   eg:
    	  ***
    	  ---
    	  ___
  

  效果：

  ---

  ---

  ---

---

6. 超链接

• 建立一个链接的语法是：[链接名称](链接地址)

  eg: [RoboMaster](https://www.robomaster.com/zh-CN)
  

  效果：
  RoboMaster

---

7. 强调

• 用一个星号*作为斜体标记;
• 用两个星号 **作为加粗标记;
• 用三个星号***作为斜体加粗标记;
• 用两个~~ 作为删除标记;

  eg:
      *这是倾斜的文字*
      **这是加粗的文字**
      ***这是斜体加粗的文字***
      ~~这是加删除线的文字~~
  

  效果：
  这是倾斜的文字
  这是加粗的文字
  这是斜体加粗的文字
  这是加删除线的文字

---

8. 行内代码

• 如果要标记一小段行内代码，可以用反引号把它包起来；

  eg: 我们可以在这里使用 `int n = 3;` 行内代码
  

  效果：
  我们可以在这里使用 int n = 3; 行内代码

---

9. 复选框

• 可以使用复选框- [ ] XXX来标注某个项目各项任务的完成情况；
• 注意【’-’ + ‘空格’ + ‘[ ]’ + 名称】为正确格式，- [x] XXX为默认勾选；

  - [x] 软件工程
  - [ ] 网络工程
  - [ ] 计算机科学与技术
  

  效果：
  • 软件工程
  • 网络工程
  • 计算机科学与技术

---

10. 图片

• 可以使用下面的代码嵌入图片：[外链图片转存失败(img-b7zhS2NY-1562503283931)(文件地址 "可选提示文本")]

  eg: [外链图片转存失败(img-ZaJb6m2g-1562503283935)(https://rm-static.djicdn.com/robomasters/public/img/gold.ef61d5e.png "冠军奖杯")]
  

  效果：
  [外链图片转存失败(img-4oIkaO93-1562503283937)(https://rm-static.djicdn.com/robomasters/public/img/gold.ef61d5e.png “冠军奖杯”)]

---

11. 表格

• 语法中第二行分割表头和内容;
• 有一个-就行，为了对齐，多加了几个;
• 文字默认居左|--|;
• 左边加:表示文字居左|:--|;
• 两边加:表示文字居中|:--:|;
• 右边加:表示文字居右|--:|;

  表头|表头|表头
  :--|:--:|--:
  内容|内容|内容
  内容|内容|内容
  

  效果：（靠左，居中，居右）

  号	姓名	爱好
  1	张三	学习
  123	李四	打篮球
  123456	王小五	吃饭睡觉

---

12. 特殊符号处理

• Markdown使用反斜杠\插入语法中用到的特殊符号，在Markdown中，主要有以下几种特殊符号需要处理：

  \\   反斜线
  \`   反引号
  \*   星号
  \_   底线
  \{}  花括号
  \[]  方括号
  \()  括弧
  \#   井字号
  \+`  加号
  \-   减号
  \.   英文句点
  \!   惊叹号
  

  eg:计算：x \+ 5 \> 10中 x 的取值范围;
  效果:
  计算：x + 5 > 10中 x 的取值范围;

其他效果设置（使用Html语言）

1. 换行
   <br/>
2. 首行缩进
   
3. 修改字体颜色
   <font color=blue > blue </font>
   效果： blue
   <font color=#00f9ff > #00f9ff </font>
   效果： #00f9ff
4. 修改字体
   <font face="微软雅黑"> 微软雅黑</font>
   效果： 微软雅黑
   <font face="黑体"> 黑体</font>
   效果： 黑体
   <font face="宋体"> 宋体</font>
   效果： 宋体
   <font face="楷体"> 楷体</font>
   效果： 楷体
   <font face="STCAIYUN"> 华文彩云</font>
   效果： 华文彩云
5. 修改字号 (注：取值范围是 1 到 7,浏览器默认值是 3)
   <font size=5 > 5号字体 </font>
   示例结果： 5号字体
6. 修改文本背景色
   <table><tr><td bgcolor=gray>这一行显示的背景色是灰色</td></tr></table>
   效果：

   这一行显示的背景色是灰色

   
   <table><tr><td bgcolor=pink>这一行显示的背景色是粉色</td></tr></table>
   效果：

   这一行显示的背景色是粉色