markdown快速入门笔记

markdown快速入门笔记_第1张图片# markdown快速入门笔记

初学markdown,边做笔记的同时,加以语法实际效果展示,以期加深记忆。

Ⅰ 、区块元素

  1. 段落和换行
  2. 标题
  3. 字体
  4. 分隔线
  5. 引用
  6. 列表

(一)段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

简而言之:按一次回车表示换行,按两下表示切换段落

一次回车:
>这是一段
>按一次回车

两次回车:
>这是一段

>按两次回车

效果如下
一次回车:

这是一段
按一次回车

两次回车:

这是一段

按两次回车

在之后的演示中,我们还将复习本段知识

(二)标题

①方法一:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 没有7级标题

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

####### 没有7级标题

②方法二:

This is an H1
=============

This is an H2
-------------

效果如下:

This is an H1

This is an H2

③方法三:

# 这是 H1 #
## 这是 H2 ##

效果如下:

这是 H1

这是 H2

(三)字体

**这是加粗的文字** 

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~

效果如下:

这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字

(四)分隔线

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

大字体分隔线a 
--- 
大字体分隔线b
---- 
小字体分隔线c
***
小字体分隔线d
*****

示例:

大字体分隔线a

大字体分隔线b

小字体分隔线c


小字体分隔线d


(五)引用

(1)普通引用

①引用与嵌套引用
> This is the first level of quoting. 
>
> > This is nested blockquote. 
> 
> Back to the first level.

②Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >:
> Donec sit amet nisl. 
Aliquam semper ipsum sit amet velit.

③引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
> ## 这是一个标题。
> > 1. 这是第一行列表项。
> 2. 这是第二行列表项。
> 
> 给出一个例子代码块(具体使用方法在:本文‘四、引用(3)代码块’的表示中):
> 
>     return shell_exec("echo $input | $markdown_script");


效果(本小节效果左侧竖杠为实际语法效果,不为强调目的使用):
①引用与嵌套引用

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

②Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >:

Donec sit amet nisl.
Aliquam semper ipsum sit amet velit.

③引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

这是一个标题。

  1. 这是第一行列表项。
  1. 这是第二行列表项。

给出一个例子代码块(具体使用方法在:本文三、引用(3)代码块的表示中):

return shell_exec("echo $input | $markdown_script");

(2)区块引用Blockquotes

> ## 我是引用区块1
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。

空出两行(按两次回车)表示上一个区块结束
> ## 我是引用区块2
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。

效果:

我是引用区块1

  1. 这是第一行列表项。
  2. 这是第二行列表项。

空出两行(按两次回车)表示上一个区块结束

我是引用区块2

  1. 这是第一行列表项。
  2. 这是第二行列表项。

(3)代码块的表示

在引用中:

①在引用中:
>
>     空出前一行,本行的行头使用五个空格表示代码块

②不在引用中:

    空出前一行,本行的行头使用四个空格表示代码块
    
 ③代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号
 ***
 ---

效果:
①在引用中:

空出前一行,本行的行头使用五个空格表示代码块

②不在引用中:

空出前一行,本行的行头使用四个空格表示代码块

(六)列表

①无序列表使用星号、加号或是减号作为列表标记:
(使用效果相同)

>*   Red
>*   Green
>*   Blue
>
>
>+   Red
>+   Green
>+   Blue
>
>
>-   Red
>-   Green
>-   Blue

②数字-句点-空白
有序列表则使用数字接着一个英文句点,再加上一个以上的空格。
且有自动修正序号的效果,也就是说你在'.'前面随便写数字都可以。
例如:

>1. Bird  
>1. McHale
>1. Paris

③列表中的引用(用四个空格或一个Tab键)
1. A list item with a blockquote: 

    > This is a blockquote 
    > inside a list item.

效果:
①无序列表使用星号、加号或是减号作为列表标记:
(使用效果相同)

  • Red
  • Green
  • Blue
  • Red
  • Green
  • Blue
  • Red
  • Green
  • Blue

②数字-句点-空白
有序列表则使用数字接着一个英文句点,再加上一个以上的空格。
且有自动修正序号的效果,也就是说你在’.'前面随便写数字都可以。
例如:

  1. Bird
  2. McHale
  3. Paris

③列表中的引用(用四个空格或一个Tab键)

  1. A list item with a blockquote:

    This is a blockquote
    inside a list item.

Ⅱ、区段元素

  1. 链接
  2. 强调
  3. 代码
  4. 图片

(一)链接

Markdown 支持两种形式的链接语法: ①行内式和②参考式两种形式。

①行内式
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

②参考式
I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3]. 
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search" 
[3]: http://search.msn.com/ "MSN Search"

链接名称式
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][]. 
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"

效果:

①行内式
This is an example inline link.
This link has no title attribute.

②参考式
I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ “Google”
[2]: http://search.yahoo.com/ “Yahoo Search”
[3]: http://search.msn.com/ “MSN Search”

链接名称式
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][].
[google]: http://google.com/ “Google”
[yahoo]: http://search.yahoo.com/ “Yahoo Search”
[msn]: http://search.msn.com/ “MSN Search”


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

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

下面链接的定义都是相同的:

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

链接网址也可以用方括号包起来:

[id]:  "Optional Title Here"

也可以把 title 属性放到下一行,也可以加一些缩进,若网址太长的话,这样会比较好看:

[id]: http://example.com/longish/path/to/resource/here 
"Optional Title Here"

网址定义只有在产生链接的时候用到,并不会直接出现在文件之中。


⑤链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写,因此下面两个链接是一样的:

[link text][a] 
[link text][A]
请注意:有一个已知的问题是 Markdown.pl1.0.1 会忽略单引号包起来的链接 title。

(二)强调

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

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

效果:

single asterisks

single underscores

double asterisks

double underscores


②强调也可以直接插在文字中间:

un*frigging*believable

un**frigging**believable

效果:

unfriggingbelievable

unfriggingbelievable

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

\*this text is surrounded by literal asterisks\*

*this text is surrounded by literal asterisks*


(三)代码

①如果要标记一小段行内代码,你可以用反引号(键盘左上角波浪键)把它包起来(’),例如:

Use the `printf()` function.

Use the printf() function.


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

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

There is a literal backtick ( ` ) here.

A single backtick in a code span: `

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

(四)图片

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

①行内式的图片语法看起来像是:

![Alt text](图片网址 '图片描述') 
![Alt text](图片网址")

详细叙述如下:

  • 一个惊叹号 !接着一个方括号,里面放上图片的替代文字
  • 接着一个普通括号,里面放上图片的网址
  • 最后还可以用引号包住并加上选择性的 ‘title’ 文字。
   ![Alt text](https://img-blog.csdnimg.cn/20190311222506230.jpg 'AI') 

效果如下:
markdown快速入门笔记_第2张图片


②参考式的图片语法则长得像这样:

![Alt text][id]

[id]:https://img-blog.csdnimg.cn/20190311222506230.jpg

效果:
markdown快速入门笔记_第3张图片


其它

(1)自动链接

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


http://example.com/

(2)反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:

\*literal asterisks\*

*literal asterisks*

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

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

参考资料 :

Markdown基本语法
Markdown教程
如何使用MarkDown输入连续的两个区块引用

你可能感兴趣的:(工具学习)