MarkDown简单应用

一、摘要

Markdown 的目标是实现「易读易写」。
Markdown 语法的目标是:成为一种适用于网络的书写语言。

ps:在 HTML 区块标签间的 Markdown 格式语法将不会被处理,而markdown语法在HTML区段标签间是有效的。

二、MarkDown简单使用

特殊字符自动转换

特殊字符(&/<)不用写成实体形式,MarkDown会自动将不是字符实体的<和&转换成&lt;和&amp;

ps:code 范围内,不论是行内还是区块, < 和 & 两个符号都一定会被转换成 HTML 实体。

段落和换行

  • 两段文字之间敲两个空格符
  • 两段文字之间空一行
  • 两段文字之间添加标签<br/>和</br>
<br/>只是第一行</br>这是第二行

ps:唯一决定两行文字是都是段落的,就在于这两行文字之间是否有空行。

标题

  • 类Setext(底线形式),利用 =(最高阶标题)和 -(第二阶标题)在每行的最前面.
  • 类Atx,在行首插入1到6个 # ,对应标题1到6阶.

ps:可以选择性地闭合类Atx,不改变标题阶级,只是美观。

区块引用(email型引用)

在每行的最前面加上 > ,也可以在整个段落的第一行最前面加 >

引用内的引用:根据层次加上不同数量的 >

ps:引用的区块内也可以使用MarkDown的语法

列表

  • 无序列表:使用星号加号或者减号作为列表标记
  • 有序列表:使用数字接着一个英文句点

※ 列表标记上使用的数字并不会影响HTML的输出结果

※ 列表项目可以包含多个段落,每个项目下的段落必须缩进四个空格或是一个制表符

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

※ 如果要在列表项目内放进引用,那>就需要缩进

※ 如果要放代码区块就要缩进两次,也就是8个空格或者2个制表符

※ 如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 <p> 标签包起来

代码区块

建立代码区块:缩进4个空格或是1个制表符

一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体

ps:代码区块中,一般的 Markdown 语法不会被转换

分隔线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西,也可以在星号或是减号中间插入空格。

* * *

***

*****

- - -

---------------------------------------
区段元素
链接

①  行内式:在方块括号后面紧接着圆括号并插入网址链接,链接的 title 文字,在网址后面,用双引号把 title 文字包起来

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

②  参考式(更好读):在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记(可以选择性地在两个方括号中间加上一个空格)接着,在文件的任意处,你可以把这个标记的链接内容定义出来

This is [an example][id] reference-style link.
[id]: http://example.com/  "Optional Title Here"

※ 链接内容定义的形式为:

  • 方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
  • 接着一个冒号
  • 接着一个以上的空格或制表符
  • 接着链接的网址
  • 选择性地接着 title 内容,可以用单引号、双引号或是括弧包着

下面三种链接定义相同:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号

[Google][]
[Google]: http://google.com/

ps:链接的定义可以放在文件中的任何一个地方

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>

※ 用什么符号开启标签,就要用什么符号结束。

如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号

如果要在文字前后直接插入普通的星号或底线,你可以用反斜线

代码

如果要标记一小段行内代码,可以用反引号把它包起来(`)

如果要在代码区段内插入反引号,可以用多个反引号来开启和结束代码区段

``There is a literal backtick (`) here.``

这段语法会产生:

<p><code>There is a literal backtick (`) here.</code></p>

代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样就可以在区段的一开始就插入反引号

A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``

※ 在代码区段内,& 和方括号都会被自动地转成 HTML 实体

图片

行内式:

一个惊叹号 !

接着一个方括号,里面放上图片的替代文字

接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

「id」是图片参考的名称,图片参考的定义方式则和链接参考一样:


[id]: url/to/image  "Optional title attribute"

ps:Markdown 还没有办法指定图片的宽高,如果需要,可以使用普通的 <img> 标签

其他
自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接

邮址的自动链接,Markdown 会先做一个编码转换的过程,把文字字符转成 16 进位码的 HTML 实体,这样的格式可以糊弄一些不好的邮址收集机器人

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签)

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

猜你喜欢

转载自blog.csdn.net/xinxinxin_rui/article/details/80460626