0%

Markdown使用

Markdown使用

宗旨

Markdown的目标就是易读易写。我们浏览网页上的内容,最终要的就是可读性,让读着看起来舒服,享受。
Markdown格式可以直接以纯文本发布,并且看起来不会像是由许多标签或者格式指令所构成,Markdown语法受到一些text-to-HTML格式的影响,但最大的灵感来源是纯文本电子邮件的格式。

兼容HTML语法

Markdown语法的目标: 成为一种适用于网络的书写语言,便于写、修改等
它的语法指令格式少,从这一方面来说Markdown不是要取代HTML。而且HTML可以直接在Markdown文件中书写。例如强调

特殊字符的自动转换

HTML文件中想要写 < 或者 &,必须用实体&lt,&amp来实现。

区块元素

段落换行

直接利用换行符br就可以
就可以。

标题

一级标题 #
二级标题 ##
依稀类推,#后面要有空格

区块引用

可以在区块中使用Markdown语法

这是一个标题

给出代码例子等;

以上显示的是一个区块,利用>来实现,最后一行>为空来结束。

列表

无序列表

用 星号加空格 来实现

  • RED
  • GREEN
  • BLUE
    或者 加号 或者 减号 加空格来实现

    有序列表

    数字加一个英文句点加空格来实现
  1. Bird
  2. Mchale
  3. 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