Markdown使用
宗旨
Markdown的目标就是易读易写。我们浏览网页上的内容,最终要的就是可读性,让读着看起来舒服,享受。
Markdown格式可以直接以纯文本发布,并且看起来不会像是由许多标签或者格式指令所构成,Markdown语法受到一些text-to-HTML格式的影响,但最大的灵感来源是纯文本电子邮件的格式。
兼容HTML语法
Markdown语法的目标: 成为一种适用于网络的书写语言,便于写、修改等
它的语法指令格式少,从这一方面来说Markdown不是要取代HTML。而且HTML可以直接在Markdown文件中书写。例如强调
特殊字符的自动转换
HTML文件中想要写 < 或者 &,必须用实体<,&来实现。
区块元素
段落换行
直接利用换行符br就可以
就可以。
标题
一级标题 #
二级标题 ##
依稀类推,#后面要有空格
区块引用
可以在区块中使用Markdown语法
这是一个标题
给出代码例子等;
以上显示的是一个区块,利用>来实现,最后一行>为空来结束。
列表
无序列表
用 星号加空格 来实现
- Bird
- Mchale
- john
- 项目列表可以包含多个段落,每个段落缩进四个空格
当然也可以不缩进,但源码不美观。 - 比如这样,要看源码。
特别说明
项目列表可能会不小心的产生,当开头是数字加.加空格的时候,要注意代码区块
缩进八个空格便可以了,代码区块中Markdown语法格式一般不会转换,如下
比如:def test(): print("hello world!") * 发放
分割线
使用三个以上星号* 减号- 或者 底线_
譬如下面,分割线行不允许有其他东西
区段元素
链接
[]方括号里写要显示的链接文字,后面跟圆括号写网址,用双引号加说明
比如:
[a link]("http://bayhax.github.io" "bayhax的博客")
this is a link
强调
用星号和_包围起来是强调,两个以上为
比如:
*强调*
**strong**
代码
标记一小段行内代码,可以使用``来标记
譬如 print("hello world")
图片
一个方括号[]里面写图片的替代文字然后是普通圆括号()图片网址,圆括号里可以用双引号“”添加说明文字
这里是图片
其他
转义\
插入星号 *
自动连接
方括号就是自动连接
比如http://bayhax.github.io