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 图片
图片的引用:叹号+中括号+小括号

如:


在这里图片引用用到了图床,具体自己百度
1.6 列表
- 使用列表之前先空一行
- 列表的每个条目以星号打头
*
-
也可以用横杠打头- tab键生成二级列表,具体自己试验下
- 支持有序列表.
- 以1.,2.,3.打头 如:
1.
- 无论你使用什么数字,都是按照1234…依次排序
- So you might want to start each line with
1.
and let me sort it out
- tab键生成二级列表,具体自己试验下
列表示例代码:
* 使用列表之前先空一行
* 列表的每个条目以星号打头 `*`
- 也可以用横杠打头 `-`
* 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 语法都可以在引用中使用.
- Lists
- 京东
- Etc.
引用示例代码:
> 尖括号 `>` 被用来块引用.
从技术上讲,引用好几段内用,并不是每一行都需要以尖括号`>`开始,只要段落与段落之间没有空行就行
> 尽管看上去有点丑陋.
> > 块引用可以嵌套.
> > > 多级嵌套.
>
> 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.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.11 本页跳转
- 先在文章任意地方设置锚点
<a name="daoyu"></a>
- 再在文章任意地方调用锚点
[回到导语](#daoyu)
比如: 回到导语
1.12 反斜杠
某些普通符号直接写在Markdown中是不显示的,
但可以通过在这些符号前面加上反斜杠来帮助它们显示:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
反斜杠示例代码
\\ 反斜线
\` 反引号
\* 星号
\_ 底线
\{} 花括号
\[] 方括号
\() 括弧
# 井字号
\+ 加号
\- 减号
\. 英文句点
\! 惊叹号
1.13 分割线
如果你输入三个星号 ***
或者 三个横杠 ---
, 将显示为水平分割线线: