2018-08-02-MarkDown使用教程

MarkDown使用教程


参考

  • Markdown 书写风格指南
  • Markdown 语法说明

语法

1.标题

标题通过 # 的个数来进行区分,Mardown总共支持6级标题

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

2.段落&换行

2.1. 首行缩进/空格:
abcdefg
 abcdefg英文空格(半角)
 中文空格(全角)
 半方大的空白 
 全方大的空白
 不断行的空白格 

abcdefg
  abcdefg英文空格(半角)
  中文空格(全角)
  半方大的空白
  全方大的空白
  不断行的空白格

2.2. 强制换行
  连续的字符串,如果你想要换行,往往打“Enter”是不管 
用的,正确的换行方法为在 「在需要换行的地方插入`
`」

  连续的字符串,如果你想要换行,往往打“Enter”是不管
用的,正确的换行方法为在 「在需要换行的地方插入

3. 列表

在Markdown下,有四种列表:有序和无序;

  • 有序列表:采用 1. 2. 3.的形式
  • 无序列表:采用前面加 * - + 的方式,支持多级嵌套
  • 未完成列表:- [ ],每个符号间均有空格
  • 已完成列表:- [x],注意空格使用
    PS: 符号与文字之间必须有空格
1. 鼠
2. 牛
4. 虎
* 鼠
  - 牛
    + 虎
* 兔

4. 引用 (Quote)

 若需要引入有出处的一段话等,可以采用引用的方式实现,实现方式为在行开始处加入>,如下所示:

> 这是引用

这是引用

5. 字体设置

**粗体**粗体
字符串前后均加上 **
*斜体*斜体
字符串前后均加上 *
~~删除线~~删除线
字符串前后各加 ~~
++下划线++:++下划线++
字符串前后各加 ++
== 字体背景色 ==:== 字体背景色 ==
字符串前后各加 ==
'标记':标记
字体前后加上 (Esc下方的那个键)

6. 分割带

当上下文不属于同一模块或者无甚关联时刻,可以使用分隔符进行隔开;分隔符的格式如下:

  • 连续多个*(>=3)
    ----

  • 连续多个*(>=3)
    ****

  • 连续多个下划线 _ (>=3)
    ___

PS:以上,分隔符中间可以有空格,但分割行不可有其它字符存在

7. 图片和链接

图片

![三十六骑](https://upload.jianshu.io/admin_banners/web_images/4358/a52cb0d0ef97a08087a234f4e25702b2471d49a4.jpg?imageMogr2/auto-orient/strip|imageView2/1/w/1250/h/540)

2018-08-02-MarkDown使用教程_第1张图片
三十六骑

链接

 [Baidu](https://www.baidu.com)

Baidu

8. 代码块

 和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用制表符来将代码包起来。
 代码块一直持续到没有缩进的那一行(或是文件的结尾)

#include   
    using namespace std;  
    int main(int argc, char **argv)  
    {
        cout << "hello,world!";
    }

9. 网址自动转换

 Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
 这个是我的博客地址:http://t.cn/Re3CO56

10. 转义

 Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:

*literal asterisks*
\*literal asterisks*

literal asterisks
*literal asterisks*

 Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号

11. 生成目录

前提条件:
 标题的建立是采用MD格式实现的,目录的生成建议放在文本最开始部分(当然也可以嵌入在文中)。
语法:

[TOC]

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

注意事项
 目录的生成并不是每个编辑器都支持的,至今我用过的编辑器 有道云笔记是支持的。

12. 表格

表格的做法通常为:

header 1 | header 2
|:---:|---:|
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2
1 2
row 1 col 1 row 1 col 2
row 2 col 1 row 2 col 2

可用
进行单元格内换行; 但是暂时不支持合并单元格

13. 数学公式写法

$ a^2 + b^2 = c^2 $

a^2 + b^2 = c^2

14. 高亮

`高亮`

高亮

你可能感兴趣的:(2018-08-02-MarkDown使用教程)