Markdown 快速入门上(基础语法篇)

Markdown 快速入门上(基础语法篇)

1. 简介

为什么使用Markdown

  • Markdown与平台无关。你可以在任何操作系统中打开Markdown文档。

  • Markdown无处不在。像Reddit和GitHub 站都是支持Markdown的,并且越来越多的 站会加入到Markdown队列中来,这是一个趋势。



2. 基本语法

Markdown的语法可以分为基本语法扩展语法, 市场的Markdown应用都应该支持基本语法。

一、标题

Markdown 在创建标题时需要在文字或者段落的前面加上**#符 ,#**的数量取决于当前标题的级别,如下

  • 示例
    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题

  • 效果

一级标题

二级标题

三级标题

四级标题

五级标题

对于一级标题和二级标题还有一种语法可以来标记,可以在一级标题下面加任意数量的**==, 在二级标题下加任意数量的–**,具体效果如下

  • 示例

一级标题
====
二级标题
—-

  • 效果

一级标题

二级标题


二、段落

创建段落时候 ,可以使用空行来隔离一行或者多行。除非段落是列表, 否则不要使用空格或者TAB来缩进段落。

  • 示例

    散文,汉语词汇,拼音是sǎn wén。一指文采焕发;二指犹行文; [1] 三指文体名。随着时代的发展,散文的概念由广义向狭义转变,并受到西方文化的影响。

    《辞海》认为:中国六朝以来,为区别韵文与骈文,把凡不押韵、不重排偶的散体文章(包括经传史书),统称“散文”。后又泛指诗歌以外的所有文学体裁。


三、强调(字体)

Markdown可以将字体格式化为加粗或者斜体。

  1. 加粗

在文字前后都加上两个或者下划线来将其中间的文字加粗, 注意的是星 或者下划线与文字之间不能有空格。

  • 示例
  • 效果

需要注意的是有时候下划线无法处理连续文字的中间部分,这个时候就需要使用来处理。所以一般的,推荐使用来加粗。

Do this Don’t do this
Love**is**bold Love__is__bold
  1. 斜体

在文字前后都加上单个或者下划线来将其中间的文字加粗, 注意的是星 或者下划线与文字之间不能有空格。

  • 示例
  • 效果

需要注意的是有时候下划线无法处理连续文字的中间部分,这个时候就需要使用来处理。所以一般的,和加粗一样推荐使用来加粗。

Do this Don’t do this
Love*is*bold Love_is_bold
  1. 加粗并倾斜

在文字前后都加上三个连续的或者下划线来将其中间的文字加粗并倾斜, 注意的是星 或者下划线与文字之间不能有空格。使用方法和上面两种一致。这里仅以星 为例:

  • 示例
  • 效果

四、引用块

Markdown在每行使用一个**>来标记引用一行,自然在引用多行时就需要在多行都使用>**来标记,并且可以和其它标记元素嵌套使用。

  1. 多行引用
  • 示例
    > ## 绝句
    >两个*黄鹂**鸣翠柳,一行白鹭上青天。
    >
    >窗含西岭*千秋雪
    ,门泊东吴万里船。

  • 效果

两个黄鹂鸣翠柳,一行白鹭上青天。

窗含西岭千秋雪,门泊东吴万里船。

  1. 嵌套引用

Markdown可以在每行多个**>来嵌套引用,>**的个数表示引用嵌套的层数。

  • 示例

>两个黄鹂鸣翠柳,一行白鹭上青天。
>>两个黄鹂鸣翠柳,一行白鹭上青天。
>>>两个黄鹂鸣翠柳,一行白鹭上青天。
>>>>两个黄鹂鸣翠柳,一行白鹭上青天。
>>>>>两个黄鹂鸣翠柳,一行白鹭上青天。

  • 效果

两个黄鹂鸣翠柳,一行白鹭上青天。

两个黄鹂鸣翠柳,一行白鹭上青天。

两个黄鹂鸣翠柳,一行白鹭上青天。

两个黄鹂鸣翠柳,一行白鹭上青天。

两个黄鹂鸣翠柳,一行白鹭上青天。


五、列表

Markdown中列表可以分为两种,分别是有序列表无序列表。列表可以与其他的标记符 进行嵌套使用。

有序列表

在纯文本前面加数字和英文句 表示一个有序列表。注意其中Markdown 语法没有要求数字是连续的,但是列表必须以数字1开头。显示效果会自动从1开始递增。

  • 示例

1. 第一项
3. 第二项
5. 第三项
4. 第四项

  • 效果
  1. 第一项
  2. 第二项
  3. 第三项
  4. 第四项

无序列表

无序列表可以在文本前面通过使用破折 (-),星 (*),或者加 (+)中的任意一种来标记。并且通过缩进来表示嵌套的列表。以下以加 (+)作为例子来演示。

  • 示例

    + 第一项
    + 第二项
    + 嵌套列表第一项
    + 嵌套列表第二项
    + 第三项

  • 效果

    • 第一项
    • 第二项
      • 嵌套列表第一项
      • 嵌套列表第二项
    • 第三项

注意在一个列表中请务必使用同一种标记符 。

有序列表和无序列表嵌套

  • 示例

1. 第一项
3. 第二项
5. 第三项
+ 嵌套第一项
+ 嵌套第二项
4. 第四项

  • 效果
  1. 第一项
  2. 第二项
  3. 第三项
    • 嵌套第一项
    • 嵌套第二项
  4. 第四项

六、 图片

在Markdown文档中插入图片的基本语法如下:

  • 语法: ![tag](link address”title”)
    • tag: 用来描述图片的关键词
    • link address: 图片的绝对地址,可以是本地的也可以是 络的
    • title: 当鼠标悬置于图片上时,出现的文字标题内容
  • 示例
    ![cute_cat](https://camo.githubusercontent.com/d518d3929e4054ce2f9183b23e52908da7e5632d/687474703a2f2f692e696d6775722e636f6d2f736732646b75592e706e673f31″cute_cat”)
  • 效果
    cat

由于本地图片只能在本地引用,这样在其他平台打开的话,图片就会失效,这个时候有一种方法就是将图片放在永久有效的 络服务器上,称之为图床。这里关于创建图床的方法可以参考: 图床连接简书连接 。


七、 代码

  1. 代码

一般地需要将文字或者段落表示为代码时,可以使用反引 来标记(`). 当段落中原本就有反引 的情况下需要使用双反应 来标记(“)

  • 示例

At the command prompt, type `nano`.
“At the command prompt, type `nano`. “

  • 效果

At the command prompt, type .

  1. 列表中代码块

在Markdown中一般的代码块是通过缩进四个空格或者一个Tab来标记的。但是当这部分代码块是嵌套在列表中时,必须使用八个空格或者两个Tab来标记。

  • 效果

    1. Open the file.

    2. Find the following code block on line 21:

    3. Update the title to match the name of your website.


八、水平分割线

水平分割线可以用三个或者多个星 (***), 破折 (—), or 下划线(___) 来标记。为了兼容性,推荐在水平分割线前后加上空行。

  • 示例

***

___

  • 效果




九、 超链接

在Markdown文档中插入超链接的基本语法主要有两种,每一种都可以与其它标记符 嵌套使用。

  1. 带标题的超链接
  • 语法: [title](URL Address)

    • title: 在文档中显示的关于超连接诶的提示内容
    • URL Address: 超链接地址
  • 示例

前面在图片章节实际上已经插入过超链接,这里再次作为示例来演示。
**[图床连接简书连接](https://www.jianshu.com/p/ea1eb11db63f)**

  • 效果

图床连接简书连接

  1. 直接显示地址的超链接
    Markdown中可以直接将URL或者邮箱地址直接放在尖括 中间来标记为插连接,鼠标点击该链接即可跳转到对应 页上去。对于点击邮箱地址,如果你安装了邮箱应用,那就直接跳转到写邮件页面。
  • 示例

<https://www.jianshu.com/p/ea1eb11db63f>

  • 效果

https://www.jianshu.com/p/ea1eb11db63f


十、 转义字符

由于标记字符都是作为格式化用途并不能被显示,markdown 和大多数其他语言一样使用反斜杠() 来转义,意思就是不要把 后面的地府识别为标记字符。

可被转义的标记字符如下表:

标记字符 名字
backslash
` backtick (see also escaping backticks in code)
* asterisk
underscore
{ } curly braces
[ ] brackets
( ) parentheses
# pound sign
+ plus sign
minus sign (hyphen)
. dot
! exclamation mark
| pipe (see also escaping pipe in tables)


文章知识点与官方知识档案匹配,可进一步学习相关知识CS入门技能树MarkDown入门MarkDown介绍24799 人正在系统学习中

声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!

上一篇 2020年8月18日
下一篇 2020年8月18日

相关推荐