Markdown 语法总结

1. 简介


首先我们需要了解什么叫Markdown。参考了很多文档,简言之,就是一种轻量级标记语言。它的优点呢,概括为以下几点:语法简单、兼容性强、导出方便、专注内容、团队写作。如果想要全面了解,可以参考 Markdown 中文文档





2. 目录

本篇文章将会介绍以下几种常用的语法


2.1. 标题
2.2. 文字格式
2.3. 列表形式
  • 2.3.1. 无序列表
  • 2.3.2. 有序列表
2.4. 表格
2.5. 超链接
  • 2.5.1. 行内式
  • 2.5.2. 参考式
2.6. 锚点
2.7. 图片
2.8. 代码
2.9. 引用






3. 语法简介


3.1. 标题
  • 语法:
      # H1一级标题
      ## H2二级标题
      ### H3三级标题
      #### H4四级标题
      ##### H5五级标题
      ###### H6六级标题
    
  • 页面展示:

    这是H1一级标题

    这是H2 二级标题

    这是H3 三级标题

    这是H4 四级标题

    这是H5 五级标题
    这是H6 六级标题




3.2. 文字格式
  • 语法:
      *斜体* 或 _斜体_;
      **粗体** ;
      ***加粗斜体***;
      ~~删除线~~;
    
  • 效果展示:
    星号格式的斜体下划线格式的斜体
    双星号的粗体
    三星号的加粗斜体
    波浪线的删除线



3.2. 列表形式
3.3.1. 无序列表
  • 语法:
      符号 空格 文字信息;
      例如:
      * 无序列表使用星号
      + 无序列表使用加号
      - 无序列表使用减号
    
    无序列表的用法很简单,有三种符号格式可实现:星号(\*)加号(+)减号(-)
    注意点,就是符号后面得添加空格,如果不添加空格就会有问题哦😯
  • 效果展示:
    • 无序列表使用星号
    • 无序列表使用加号
    • 无序列表使用减号

3.3.2. 有序列表
  • 语法:
      数字接着一个英文句点,
      例如:1. 第一条
    
  • 注意点:
    对于语句2018. 就要匆匆过去了,会发现这里的2018. (数字 英文句点 空白)被认为成一个有序列表啦!
    解决这种问题,在英文句点(.)前面添加反斜杠(\)就可以啦!
    改为:2018\. 就要匆匆过去了。
    整篇文章就是有序列表格式,感觉没什么好展示了。🤣🤣🤣



3.4. 表格
  • 语法:

      表头1|表头2|表头3|表头4
      :-:|:-|-:|-
      居中|居左|居右|无变化
    
  • 说明:
    首先了解符号:冒号(:) 表示对齐方式; (|)可以认为是一个隔开的作用吧!
    (:) 与 (|) 之前尽量不要有空格,否则可能有兼容性问题。
    如果需要合并单元格或者特殊格式处理,只能说一声抱歉啰!

  • 效果展示:

    表头1 表头2 表头3 表头4
    居中 居左 居右 无变化
    效果 是不是 非常 明显呀




3.5. 超链接

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

3.5.1. 行内式
  • 语法:

      [链接文字](链接地址 “title”)
    
  • 说明:
    [] 里填写链接文字;就是界面上看到的那个文字。
    () 里填写链接地址;就是需要跳转的地址。
    title属性:就是鼠标悬浮时展示的文字,该项非必填。

  • 效果展示:
    这个链接可以跳转到 Flex布局总结 哦!

3.5.2 参考式
  • 语法:
      [链接文字][链接别名]
      [链接别名]: 链接地址 
    
  • 说明:
    这种用法呢,一般出现在学术论文中,或者多次使用链接地址。
    对链接地址进行里很好的管理,就像抽取里一个变量,然后到处去使用一样。
    如果链接别名为空,可以对链接文字直接写上一个地址。
  • 效果展示:
    我认为 Lodash 中文文档是一个很好的文档,刚开始接触的时候很不适应,但是接触 Lodash 久了,就发现它妙不可言!


自动链接
  • 语法:
      自动链接:<链接地址>
    
  • 说明:
    支持比较短的自动链接形式来处理网址和电子邮箱电子信箱,一般链接地址就是和链接文字一样哦!



3.6. 锚点
  • 语法:
    1. 提供可以跳转的链接,
      [详情](#anchorText)
    
    2. 跳转的地方设置一个 id,其实只要是 html 中可以带 id 属性的标签都可以。
      <div id="anchorText"></div>
    

不过我好像在简书里尝试了很久,没办法生效,似乎不支持这种语法。



3.7. 图片

同超链接非常像的方式!

  • 语法
      ![图片Alt](图片地址 “图片Title”)
    
  • 说明:
    图片Alt:这个就是图片没有加载出来的时候,然后就会显示这个文字啦。
    图片Title:悬浮的时候现实的文字。

Alt文字:稳住




3.8. 代码
  • 语法:
    代码块形式:一对```
    ```
      var  a = 1;
      console.log(a, '就这么方便啊');
    ```
    单行代码形式:``
    `console.log(1)`
  • 效果:
        var  a = 1;
        console.log(a, '就这么方便啊');
    
    console.log(1)



3.9. 引用
  • 语法:
      > 非常方便,符号(>) 后面直接文字信息;
      >> 层级越多就是符号越多啰,很好理解把!
    
  • 效果展示:

    告诉你们一件事情,我是引用文字啊!!!

    第二层

    第三层

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 0. 目录 0. 目录1. 斜体和粗体2. 分级标题3. 超链接3.1. 行内式3.2. 参考式3.3. 自动链接...
    跃文阅读 1,367评论 0 1
  • 0.目录(Table of Contents) 在需要目录出现的地方放置一个标记,这样会自动生成一个嵌套的包含所有...
    日居_月诸阅读 9,808评论 1 10
  • 1. 斜体和粗体 代码示例 效果示例 这是斜体这是粗体这是斜体加粗体这是删除线 2. 分级标题 代码示例 效果示例...
    d9ead1a8ce9c阅读 352评论 0 0
  • 标题 标题是最常用的格式,只要在文本前加上#即可,在Markdown里标题分为6级,一个#号标题字号最大,6个#号...
    Waldo_cuit阅读 465评论 0 3
  • 昨天晚上在教练的引导入开始制定2018年的计划,第一次用这种方式来制定新年计划,却给我带来全新的感触。 首先是从2...
    启子平阅读 232评论 0 0