Markdown 学习

目录
一 Markdown介绍
1.1 什么是Markdown
1.2 Markdown是谁创造的?
1.3 为什么要使用Markdown
二 Markdown 语法
2.1 标题
2.2 无序列表
2.3 有序列表
2.4 区块引用
2.5 分割线
2.6 链接
2.7 图片
2.8 代码框
2.9 表格
2.10 强调
2.11 转义
2.12 删除线
2.13 缩略标签
三 结语

一 Markdown介绍

1.1 什么是Markdown?

Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。 Markdown 文件的后缀为 .md。

1.2 Markdown是谁创造的?

它是由 Aaron SwartzJohn Gruber 共同设计, Aaron Swartz 就是那位(2013年1月11日)自杀,有着开挂一般人生经历的程序员。 维基百科对他的介绍是:软件工程师、作家、政治组织者、互联网活动家、维基百科人。

1.3 为什么要使用Markdown?

  • 它是易读(看起来舒服😌)、易写(语法简单)、易更改(纯文本)。处处体现着极简主义的影子。
  • 兼容HTML,可以转换为HTML格式发布。
  • 跨平台使用。
  • 越来越多的网站支持Markdown.
  • 更方便清晰的组织你的电子邮件。(Markdown-here,Airmail)。
  • 摆脱Word,txt!!!

二 Markdown 语法

2.1 标题

  • 用法介绍:标题可以像 HTML 一样使用一级至六级标题,使用 # 即可,一级标题的使用方法为:# 一级标题,几级标题就使用几个 #。

  • 写法

      #### 四级标题
      ##### 五级标题
      ###### 六级标题
    
  • 演示

    四级标题

    五级标题
    六级标题

2.2 无序列表

  • 用法介绍:无序列表可以使用 * + - 这三种格式,这里推荐使用*:* 列表1

  • 写法

      * 列表1
      + 列表2
      - 列表3
    
  • 演示

    • 列表1
    • 列表2
    • 列表3

2.3 有序列表

  • 用法介绍:有序列表使用数字1. **即可,如果开始数字是3,那这个列表就从3. \**开始,第二条是4. ***

  • 写法

      1. 列表1
      2. 列表2
      3. 列表3
    
  • 演示

    1. 列表1
    2. 列表2
    3. 列表3

2.4 区块引用

  • 用法介绍:区块引用使用 > 这个符号,空格后放文本即可:> 一级区块

  • 写法

      > 注意:区块引用的左边,有个竖线!
      >> 注意:引用还可以嵌套使用,这是二级的引用,二级以上相信你也懂了
      >>> 注意:这是三级嵌套,相信你知道怎么用了
    
  • 演示

    注意:区块引用的左边,有个竖线!

    注意:引用还可以嵌套使用,这是二级的引用,二级以上相信你也懂了

    注意:这是三级嵌套,相信你知道怎么用了

2.5 分割线

  • 用法介绍:分割线使用三个及以上的 * 或者 - 或者 _ 都可,这里使用三个 *:***

  • 写法

      ***
      ---
      ___
    
  • 演示




2.6 链接

  • 介绍:链接分为行内式和参数式这两种方法

2.6.1 行内式

2.6.2 参数式

  • 写法

    ```

  [site]:https://webmryang.github.io "网站"
  [网站]:https://webmryang.github.io "网站"

  这里是 [site],这里是 [网站]
```
  • 演示

这里是 site,这里是 网站

2.7 图片

  • 用法介绍

    如果是本地图片,则支持绝对路径和相对路径 如果是网络图片,则可以使用 http://** 来引入 如果是 base64,怎么使用参考 markdown 引用 base64

  • 写法

      ![图片](https://qq.yh31.com/tp/zjbq/201901182223553205.gif)
    
  • 演示

    图片

2.8 代码框

  • 介绍:代码框分为单行用和多行用这两种方法:

2.8.1 单行用

  • 写法

      `<p>你好使用者,要看看</p>`
    
  • 演示

    <p>你好使用者,要看看</p>

2.8.2 多行用

  • 写法

    ```

    你好使用者,要看看

    你好使用者,要看看

    ```

  • 演示

    <p>你好使用者,要看看</p>
    <p>你好使用者,要看看</p>
    

2.9 表格

  • 介绍:表格有三种表示方法:

2.9.1 第一类表格

  • 写法

      | name | age | sex |
      | :---: | :--- | ---: |
      | webmryang | 23 | 男 |
      | 小杨 | 23 | 男 |
    
  • 演示

name age sex
webmryang 23
小杨 23

2.9.2 第二类表格

  • 写法

      | name | age | sex |
      | --- | --- | --- |
      | webmryang | 23 | 男 |
      | 小杨 | 23 | 男 |
    
  • 演示

name age sex
webmryang 23
小杨 23

2.9.3 第三类表格

  • 写法

      学号 | 姓名 | 分数
      - | - | -
      小明 | 男 | 75
      小红 | 女 | 79
      小陆 | 男 | 92
    
  • 演示

学号 姓名 分数
小明 75
小红 79
小陆 92

2.10 强调

2.10.1 字体倾斜

  • 写法

      *字体倾斜*
      _字体倾斜_
    
  • 演示

    字体倾斜 字体倾斜

2.10.2 字体加粗

  • 写法

      **字体加粗**
      __字体加粗__
    
  • 演示

    字体加粗 字体加粗

2.11 转义

  • 用法介绍:通过使用\加上特殊字符,达到转义效果。

    • 写法

        * \\
        * \`
        * \~
        * \*
        * \_
        * \-
        * \+
        * \.
        * \!
        * ……
      
    • 演示

    • \

    • `
    • ~
    • *
    • _
    • -
    • +
    • .
    • !
    • ……

2.12 删除线

  • 用法介绍请删除我吧

    • 写法

        ~~请删除我吧!~~
      
    • 演示

    请删除我吧!

2.13 缩略标签

  • 用法介绍缩略标签属于 HTML 中的内容,但是巧妙用在 Markdown 也是可行的。

    • 写法

        <details>
        <summary>基础知识</summary>
      
        被缩略
      
        你还需要知道其他的吗?
      
        </details>
      
    • 演示

    基础知识 被缩略 你还需要知道其他的吗?

三 结语

至此,Markdown 语法介绍完毕,有兴趣的小伙伴继续去了解更深层次的 Markdown 语法吧!

Copyright © webMrYang.top 2019 all right reserved,powered by Gitbook该文件修订时间: 2019-06-19 15:02:56

results matching ""

    No results matching ""