能读懂英文的小伙伴请转到下面网站，里面的内容更专业，更具体
Markdown文档
以下内容为阉割版，旨在提供一个速查的文档
正文：
What's Markdown
Markdown是一个轻量级的标注语言，可用于向明文文本文档添加格式元素。使用Markdown与WYSIWYG编辑器的区别在于，当你创建一个Markdown-formatted文件时，你向文件中的文本添加Markdown句法以表明想要哪些词语或句子表现得不同，最终的表现结果需要特定的编辑器显示。而当使用MS Word你点的每个按钮去修改单词和句子时，那些变化都会实时显示出来。
How does it work
当你使用Markdown写作时，你需要将文本保存在带有.md或.markdown后缀的文件中。那你的.md文件是如何转换成HTML或者PDF(print-ready document file)呢？简单来说你需要用一个可以处理Markdown文件的应用。Markdown应用使用一个叫做Markdown解析器接受Markdown文件然后将其输出为HTML文件，然后你的文档就可以在web浏览器上查看或者打印。
Note:markdown应用和解析器是两个不同的组件，为了简洁起见，我把两个组合在一个markdown app中。
Markdown文件处理流程
Why is Markdown
Markdown是一种快速简便的记录笔记，为网站创建内容以及生成可打印文档的方法。你不需要花太多时间学习Markdown语法，而且一旦你掌握了Markdown，你可以在任何地方使用它书写。Markdown是为了网站而设计的，它也可以用来记录笔记，或者编写格式漂亮的博客。具体用途请参照What's Markdown good for?
Makrdown syntax
1.文本结构
# ,## ,... ,##### 分别创建1,2,...,5级标题，如：
# 这是第一级标题
这是第一级标题
# 这是第五级标题
这是第五级标题
当你需要将创建一个段落时，使用一行空行，两行空行和一行空行的效果是一样的。
无法使用空格和TAB键来缩进段落。如果需要使用空格进行段落缩进，可以使用下面语法：
一个空格  或者 
两个空格  或者 
不断行空格 或者 
断行则需要输两个空格或者更多，然后再按回车键。
不过有些markdown编辑器实现了只需按回车键就可以换行，比如说简书里的markdown。
你可以在有序或者无序的列表里组织事物。
使用符号"+", "-", "*"创建无序列表，符号和文本之间有一个空格，如：
+ 苹果
+ 香蕉
+ 梨子
结果为：
- 苹果
- 香蕉
- 梨子
使用数字创建有序列表，如：
- item 1
- item 2
- item 3
结果为：
- item 1
- item 2
- item 3
数值的大小不影响排列顺序，但是会以第一个数字开始递增(在数字前加"\"是为了查看原始文本)，如：
\2. item 1
\3. item 2
\1. item 3
结果为(将上面的"\"去掉得到下面结果)：
- item 1
- item 2
- item 3
创建嵌套列表(有序列表和无序列表规则相同)：
+ 苹果
+ 红苹果
+ 青苹果
+ 香蕉
+ 梨子
- 苹果
- 红苹果
- 青苹果
- 香蕉
- 梨子
2.字体
让字体变斜，使用语法：* 文本 * 或者 _ 文本 _
让字体变粗，使用语法：** 文本 ** 或者 __ 文本 __ (两个下横杠）
让字体又粗又斜，使用语法：*** 文本 *** 或者 ___ 文本 ___ (三个下横杠）
如果你想引用某位××家所说的话呢，比如说：
珍爱生命，学会放弃
又或者想在一个段落最后加个Note，比如上面的那个，那么你就可以用">"在段落的开头，记住只能用在开头，在句子中间无法生效。如：
> 哈哈，上面那句话是跑半马的时候我在小姐姐举的牌子上看到的
哈哈，上面那句话是跑半马的时候我在小姐姐举的牌子上看到的
如果想要退出引用模块，就得另起段落，哎呀，忘了
这次成功了
当然，可以在引用文字里再使用引用文字，使用">>"即可。如：
>第一层
>>你猜有没有第三层
又忘记退出引用文字了
第一层
你猜有没有第三层
又忘记退出引用文字了
在引用文字里可以使用其他元素，比如字体加粗，变斜，创建标题。
3.表格 & 代码块
使用"|"来创建表格，语法为：
| Syntax | Description | 这一行为表头
| ----------- | ----------- | 表头与表项的分割，"-"数量不限，但不能没有
| Header | Title | 表项
| Paragraph | Text | 表项
| Syntax | Description |
|---|---|
| Header | Title |
| Paragraph | Text |
提示：一个高效的建表网站Markdown Tables Generator
还可以改变表格中的文本位置，让文本位于左侧，居中或者右侧，语法如下：
| Syntax | Description | Test Text |
| :--- | :----: | ---: |
| Header | Title | Here's this |
| Paragraph | Text | And more |
| Syntax | Description | Test Text |
|---|---|---|
| Header | Title | Here's this |
| Paragraph | Text | And more |
在分割线左侧加冒号就使文本位于左侧，两边都加冒号就为中间，右侧加冒号使文本位于右侧
创建代码块使用语法：
``` 代码块 ```
( ` 是数字1左边的那个)如：
import numpy as np
import cv2
cap = cv2.VideoCapture(0)
while(True):
# Capture frame-by-frame
ret, frame = cap.read()
# Our operations on the frame come here
gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
# Display the resulting frame
cv2.imshow('frame',gray)
if cv2.waitKey(1) & 0xFF == ord('q'):
break
# When everything done, release the capture
cap.release()
cv2.destroyAllWindows()
源格式为：
```
import numpy as np
import cv2
cap = cv2.VideoCapture(0)
while(True):
# Capture frame-by-frame
ret, frame = cap.read()
# Our operations on the frame come here
gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
# Display the resulting frame
cv2.imshow('frame',gray)
if cv2.waitKey(1) & 0xFF == ord('q'):
break
# When everything done, release the capture
cap.release()
cv2.destroyAllWindows()
```
还可以在第一个```右边加上对应语言名称，可以得到代码的高亮(简书里好像自动高亮)
源格式为：
```python
Python代码块
```
如果只是表明某个单词或者句子为代码，那么可以用 ` 将其包含起来，如：
print("code")
源格式为：
`print("code")`
4.页内跳转&插入图片&插入URL
简书目前好像不支持页内跳转，如果有小伙伴知道如何在简书内实现跳转，希望能在评论区留下方法或者相应的文章链接。插入图片和URL相对简单，就不放在上面了
5.结语
Markdown绝不止这么点内容，还有更多的知识有待探索。现阶段只是把它当作一个写博客和在Github上写README.md的工具。更多功能在以后的学习中慢慢积累，此文章也会持续更新。
网友评论