以前没有接触过Markdown,了解之后,发现它很适合我这种带有略微“强迫症”的程序猿,简单、明了。关于Markdown的介绍,这里就不多说了,百度一大堆。关于Markdown编辑器,也有很多,试用了几个,都差不多,也不做推荐了。
PS:虽然之前一直用Github,但说来惭愧,一直认为.md是普通的说明文档。
关于标题
需要几级标题,就用几个井号#开头,并以相同个数的#结尾,但结尾的#不是必须的,只是为了美观对称。##二级标题##
###三级标题###
还有另外一种显示标题的方法,即下一行用=或-标记,这里的=或者-的个数无所谓:一级标题
========
二级标题
----------
区块引用
如果你需要引用别处的一小段,可以使用 > 这种符号。使用多个 > 符号,可以产生分层的效果。如果想消除引用的效果,可在一行中输入多个空格,然后回车,或者使用多个连续换行。>引用说明:......
>>分层次说明:......
引用说明:......
分层次说明:......
同时,在区块引用可以使用其他语法。> ###### 这是一个标题
关于列表:有序和无序
无序列表使用星号、加号或是减号加空格作为列表标记。同时支持混合使用:* Red
* Green
* Blue
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
有序列表则使用数字接着一个英文句点。这里貌似和直接输出没什么区别,但在html代码中是有区别的:1. Bird
2. McHale
3. Parish
1. Bird
2. McHale
3. Parish
关于代码
Markdown中的代码块需要缩进 4 个空格或是 1 个制表符,且代码块前必须空一行:
for line in open("new", "r"):
frags = line.split("\t")
url = frags[0].strip()
product = frags[5].strip()
if len(product) > 5:
if url not in data:
data[url] = {}
data[url]["new"] = product
代码块会一直持续到没有空格或换行符的一行,或者文件的默认。
还有一种方式,本文中经常使用的:` `。注意两者的区别:
`
import sys
sys.stdout.write("hello, word")
`import sys
sys.stdout.write("hello, word")
其他说明
分隔线:可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。
* * *
***
*****
- - -
______
图片或链接地址
图片例子:
链接例子:[百度链接地址](https://baidu.com "baidu.com")
百度链接地址
粗体和斜体:非常简单,用两个*或_包含一段文本就是粗体,用一个*或_包含一段文本就是斜体。
**这里是粗体**
__这里是粗体__
这里是粗体
这里是粗体*这里是斜体*
_这里是斜体_
这里是斜体
这里是斜体
反斜杠:可以利用反斜杠来插入一些在语法中有其它意义的符号
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。