MacDown语法

发表于 | 分类于

导语

Markdown 的理念是，能让文档更容易读写和随意改。

基本语法:

  1. 如何换行
  2. 加粗 斜体
  3. 标题
  4. 链接 邮箱
  5. 图片
  6. 分类
  7. 引用
  8. 代码
  9. 代码块
  10. 表格
  11. 本页跳转 如:回到顶部
  12. 反斜杠
  13. 分割线

1.1 如何换行

强制换行:在一行的最末敲两次空格加一次回车

1.2 加粗 and 斜体

加粗: 用双星号包裹**Strong**
斜体: 用单星号包裹*Emphasize*
加粗和斜体示例代码: 

**加粗**: 用双星号包裹`**Strong**`  
*斜体*: 用单星号包裹`*Emphasize*`

1.3 标题 (就像本行)

一个#号字体最大, 6个#号字体最小
标题代码示例: 

# 标题 1
## 标题 2
### 标题 3
#### 标题 4
##### 标题 5
###### 标题 6

1.4 链接 and 邮箱

写法一:
网址和邮箱 可用尖括号包裹使其可点击:
http://macdown.uranusjr.com
uranusjr@gmail.com
写法一示例代码:
<http://macdown.uranusjr.com>
<uranusjr@gmail.com>

写法二:
也许你需要一些这样的链接文本:
Macdown Website
写法二示例代码
[Macdown Website](http://macdown.uranusjr.com)

1.5 图片

图片的引用:叹号+中括号+小括号
![名称随意](图片url) 如:
![M12](http://images.wxyass.com/wxyass/images/blog_xintouxiang.png)
![M34](http://images.wxyass.com/wxyass/images/blog_xintouxiang.png)
M12
M34

在这里图片引用用到了图床,具体自己百度

1.6 列表

  • 使用列表之前先空一行
  • 列表的每个条目以星号打头*
  • - 也可以用横杠打头
    • tab键生成二级列表,具体自己试验下
      1. 支持有序列表.
      2. 以1.,2.,3.打头 如: 1.
      3. 无论你使用什么数字,都是按照1234…依次排序
      4. So you might want to start each line with 1. and let me sort it out

列表示例代码: 

1
2
3
4
5
6
7
8
* 使用列表之前先空一行
* 列表的每个条目以星号打头 `*`
- 也可以用横杠打头 `-`
	* tab键生成二级列表,具体自己试验下
		1. 支持有序列表.
		2. 以1,2,3打头 如: `1. `
		42. 无论你使用什么数字,都是按照1234...依次排序
		1. So you might want to start each line with `1.` and let me sort it out

1.7 引用

尖括号 > 被用来引用.
从技术上讲,引用好几段内容时,并不是每一行都需要以尖括号>开始,只要段落与段落之间没有空行就行
尽管看上去有点丑陋.

块引用可以嵌套.

多级嵌套.

许多markdown 语法都可以在引用中使用.

引用示例代码: 

1
2
3
4
5
6
7
8
9
10
11
> 尖括号 `>` 被用来块引用.  
从技术上讲,引用好几段内用,并不是每一行都需要以尖括号`>`开始,只要段落与段落之间没有空行就行  
> 尽管看上去有点丑陋.
> > 块引用可以嵌套.  
> > > 多级嵌套.
>
> Most markdown syntaxes work inside block quotes.
>
> * Lists
> * [京东](https://www.jd.com)
> * Etc.

1.8 代码

代码: 用单引号(该键位在tab键上方)包裹
private void initData(){}
代码示例代码
`private void initData(){}`

如果你的代码中有单引号并且需要展示,你可以使用两次单引号包裹已经存在的单引号:
Code with `backticks`
有单引号代码示例代码

``Code with `backticks` `` ```` 
1
2
3
4
5
6
#### <a name="9"></a>1.9 代码块  
显示一个代码块有两种方式:  
###### 1. 用3个单引号(该键位在tab键上方)包裹  
```This is a code block

2. 先空一行,使用tab键或者缩进四个空格,在写入代码,具体自己试验。
print('This is a code block')
print('The block must be preceded by a blank line')
print('Then indent at least 4 spaces or 1 tab')
print('Nesting does nothing. Your code is displayed Literally')

1.10 表格

表格示例代码: 

| 链接 | 结果 | 原因 |
|:-----|:---:|----------:|
|文本内容| **`是`** |同协议同域名同端口|
|文本内容| **`是`** |同协议同域名同端口|
|文本内容| **`是`** |同协议同域名同端口|

代码解释:

  1. 使用表格之前, 需先空一行, 切记表格要与上面的文本内容空一行, 否则解析不出来
  2. 上面第一行是表格的表头。第二行的冒号位置决定表格内文本的对齐方式。有水平居中、水平靠左对齐、水平靠右对齐三种.
  3. 每列的宽度是根据对应列里最长的文本来决定的

输出结果：

链接 结果 原因
文本内容 是 同协议同域名同端口
文本内容 是 同协议同域名同端口
文本内容 是 同协议同域名同端口

1.11 本页跳转

  1. 先在文章任意地方设置锚点 

    <a name="daoyu"></a>

  2. 再在文章任意地方调用锚点 

    [回到导语](#daoyu)

    比如: 回到导语

1.12 反斜杠

某些普通符号直接写在Markdown中是不显示的,
但可以通过在这些符号前面加上反斜杠来帮助它们显示：

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

反斜杠示例代码

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

1.13 分割线

如果你输入三个星号 *** 或者 三个横杠 --- , 将显示为水平分割线线: