Markdown使用笔记

概要介绍

Markdown 是一种轻量级的「标记语言」，优点在于
- 专注你的文字内容而不是排版样式。
- 轻松的导出 HTML、PDF 和本身的 .md 文件。
- 纯文本内容，兼容所有的文本编辑器与字处理软件。
- 可读，直观。适合所有人的写作语言。

语法简明概述

• 分段 两个回车
• 换行 两个空格 或者 回车
• 标题 # ~ ######，#号的个数表示几级标题，即表示一级标题到六级标题
• 强调 **文字** ， __文字__ ， _文字_ ， *文字* ， 文字
• 模块引用 > 注意后面紧跟个空格
• 表格 - 和 | 分割行和列 ， : 控制对其方式
• 代码块 `四个空格 开头或， 使用三个点+代码内容+三个点
• 链接 [文字](链接地址)
• 图片 ![图片说明](图片地址) ，地址可以是本地路劲，也可以是网络地址
• 列表 * ， + ， - ， 1. ，选其中之一，注意后面紧跟个空格

内容强调

字体 **加粗** 显示
字体 *斜体* 显示
字体 ***加粗并斜体*** 显示

加粗、斜体
字体 加粗 显示
字体 斜体 显示
字体 加粗并斜体 显示

字体 __加粗__ 显示
字体 _斜体_ 显示
字体 ___加粗并斜体___ 显示
组合 *__加粗并斜体__* 显示

字体 加粗 显示
字体 斜体 显示
字体 加粗并斜体 显示
组合 加粗并斜体 显示

列表

无序代码:

- 无序列表1
- 无序列表2
- 无序列表3

效果如下：

• 无序列表1
• 无序列表2
• 无序列表3

有序代码：
语法规则：在数字和“.”号之后加一个空格，再跟列表项的内容。

1. 有序列表1
 2. 哈哈 
 3. 溜溜
2. 有序列表2
3. 有序列表3

效果如下：

1. 有序列表1
   
   1. 哈哈
   2. 溜溜
2. 有序列表2
3. 有1序列表3

表

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

效果如下：

First Header	Second Header
Content Cell	Content Cell
Content Cell	Content Cell

code

1.Ctrl +K
2. 点点点

- 填充(padding)
元素内容与边框之间是可以设置距离的，称之为“填充”。填充也可分为上、右、下、左(顺时针)。
        div{padding:20px 10px 15px 30px;}/*上、右、下、左(顺时针)，顺序不要搞混*/
        div{
             padding-top:20px;
             padding-right:10px;
             padding-bottom:15px;
             padding-left:30px;
        }
        div{padding:10px;}/*上、右、下、左的填充都为10px;*/
        div{padding:10px 20px;}/*上下填充一样为10px，左右一样为20px*/  ``

效果如下：
- 填充(padding)
元素内容与边框之间是可以设置距离的，称之为“填充”。填充也可分为上、右、下、左(顺时针)。

 div{padding:20px 10px 15px 30px;}/*上、右、下、左(顺时针)，顺序不要搞混*/
        div{
             padding-top:20px;
             padding-right:10px;
             padding-bottom:15px;
             padding-left:30px;
        }
        div{padding:10px;}/*上、右、下、左的填充都为10px;*/
        div{padding:10px 20px;}/*上下填充一样为10px，左右一样为20px*/  

举例代码2

比如插入下面一段代码：

#include <iostream>
using namespace std;
int main(){
  cout << "hello markdown" << endl;
  return 0;
}

语法规则是：
在需要高亮的代码块的前一行及后一行使用三个反引号“`”，同时第一行反引号后面表面代码块所使用的语言
在行内的代码可以使用两个反引号包住，例如 printf() 就是输入`printf()` 得到的。

图片

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式:行内式和参考式。
- 行内式的图片语法

![Alt text](/path/to/img.jpg)//方括号里面放上图片的替代文字,接着的普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字
![Alt text](/path/to/img.jpg "Optional title")

• 参考式的图片语法

![Alt text][id]
//「id」是图片参考的名称，
//图片参考的定义方式则和连结参考一样：
[id]: url/to/image  "Optional title attribute"

水平规则

Three or more...

---

Hyphens

***

Asterisks

效果如下：

Three or more…

---

Hyphens

---

Asterisks

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），你可以在星号的前面加上反斜杠：

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

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

参考文章
Markdown 语法说明(简体中文版)
Markdown常用语法 | Xuan’s blog