MarkDown:基础知识

MarkDown:基础知识

获取Markdown格式语法的要点

这页提供了 markdown 简单的概述给想使用的人,语法说明 页提供了完整详细的文件,说明每项功能,但是Markdown其实很简单就可以上手,这页文件提供了一些范例,并且每个范例都有提供输出的HTML结果。

其实直接试试看也是一个很不错的方法,Dingus是一个网页应用程序,让你可以把你的Markdown文件转成XHTML。

Note: 这份文件本身也是用markdown写到,你也可以看看它的原始文件

段落、标题、区块代码

一个Enter(回车)代表空格,
两个Enter(回车)代表分段

一个段落实由一个以上的连接的行句组成,而一个以上的空行则会切分出不同的段落(空行的定义是显示上看起来像是空行,就被视为空行,例如有一行只有空白和tab,那该行也会被视为空行),一般的段落不需要用空白或断行缩排。

markdown支持两种标题语法,[Setext][1]和[atx][2]形式,Setext形式使用底线的形式,利用=(最高阶标题)和-(第二阶标题),Atx形式在行首插入1到6个#(井号),对应到标题1到6阶。

区块引用则使用email形式的'>'(角括号、大于号)表示。

Markdown语句:

A First Level Header(一级标题)
====================

A Second Level Header(二级标题)
---------------------

我思故
我在
--笛卡尔

Header 3(三级标题)

> 这是一个引用
>
> 这是引用的第二段
>
> ## 这是引用中的二级标题

输出的HTML语句:

A First Level Header(一级标题)

A Second Level Header(二级标题)

我思故
我在
--笛卡尔

Header 3(三级标题)


这是一个引用

这是引用的第二段

这是引用中的二级标题


斜体和粗体

Markdown使用*(星号)和_(底线)来标记需要强调的文本。

Markdown:

部分文字为斜体
同样有部分文字为_斜体_

使用两个星号代表强调
或者,如果您愿意,使用两个下划线代替

输出的HTML语句:

部分文字为斜体
同样有部分文字为斜体

使用两个星号代表强调
或者,如果您愿意,使用两个下划线代替

列表

无序列表使用*(星号)、+(加号)和-(减号)来作为列表的项目标记,这些符号都是可以使用的。

使用*(星号):

* 糖果
* 口香糖
* 酒

使用+(加号):

+ 糖果
+ 口香糖
+ 酒

使用-(减号):

- 糖果
- 口香糖
- 酒

都会输出:


  • 糖果

  • 口香糖


有序列表则使用一般的数字和英文句号作为项目标记:

  1. 红色
  2. 绿色
  3. 蓝色

输出:


  1. 红色

  2. 绿色

  3. 蓝色

如果你在项目之间插入空行,那么项目的内容会用<p>标签包起来,你也可以在一个项目内放上多个段落,只要在它前面缩进4个空格或1个tab。

* 列表项。

有多个段落。

* 列表中的另一项。

输出:



  • 列表项。


    有多个段落。




  • 列表中的另一项。



Markdown支持两种形式的插连接语法: 行内参考 两种形式,两种都是使用[]方括号来把文字转成超链接。

行内形式是直接在[]方括号和面附上链接地址:

这是一个示例链接

输出:

这是一个示例链接

你也可以选择性的加上 title 属性:

这是一个示例链接

输出:

这是一个示例链接

参考形式的超链接让你可以为超链接定义一个名称,之后你可以在文件的其他地方定义该超链接的内容:

访问[百度][1],[腾讯][2],[阿里巴巴][3]。

[1]: https://www.baidu.com/ "百度"
[2]: https://www.tencent.com/zh-cn/index.html "腾讯"
[3]: http://www.alibaba.com/ "阿里巴巴"

输出:

访问
百度
腾讯
阿里巴巴

title 属性是选择性的,连接名称可以用字母、数字和空格,但是不分大小写:

访问[腾讯首页][QQ]

[qq]: http://www.qq.com/ "腾讯网"

输出:

访问腾讯首页

图片

图片的语法和超链接很像。

行内行式(title 是选择性的):

MD

參考形式:

![MD][id]

[id]: https://i.imgur.com/hRqgd0o.jpg "Markdown"

上面兩種方法都會輸出:


MD

代码

在一般的段落文字中,你可以使用反引号` 来标记程序码区段,区段内的&<>都会被自动装换成HTML实体&amp;&lt&gt;,这项特性让你可以很容易的在程序区段内插入HTML码:

我强烈建议不要使用任何<blink>标签&。

输出:

我强烈建议不要使用任何<blink>标签&。

如果要建立一个已经格式化好的程序码区块,只要每行都缩进4个空格或是一个tab就可以了,而&<>也一样会自动装成HTML实体。

Markdown:

如果您希望您的页面在XHTML 1.0 Strict下验证,
你必须在你的blockquotes中放置段落标记:


例子


输出:


如果您希望您的页面在XHTML 1.0 Strict下验证,
你必须在你的blockquotes中放置段落标记:


<blockquote>
<p>例子</p>
<blockquote>

markdowm首行缩进方法
一个汉字占两个空格大小,所以使用四个空格就可以达到首行缩进两个汉字的效果。有如下几种方法:

一个空格大小的表示:&ensp;&#8194;,此时只要在相应需要缩进的段落前加上 4个 如上的标记即可,注意要带上分号。

两个空格的大小表示:&emsp;&#8195;,同理,使用2个即可缩进2个汉字,推荐使用该方式。

不换行空格:&nbsp;&#160;,使用4个 即可。

posted @ 2018-07-31 22:01  清澈动听  阅读(425)  评论(0)    收藏  举报