MarkDown语法教程

作者: 18587a1108f1 | 来源:发表于2017-07-28 17:41 被阅读51次

    前言
    We believe that writing is about content, about what you want to say – not about fancy formatting.
    我们坚信写作写的是内容,所思所想,而不是花样格式。
    — Ulysses for Mac

    主要内容

    (一)Markdown 是什么
    (二)为什么要使用 Markdown
    (三)如何使用 Markdown
    (四)Markdown 编辑器

    正文

    (一)Markdown是什么

    Markdown 是一种轻量级的 标记语言,以 纯文本 的形式编写文档,通过简洁的语法代替排版,并且可以导出 HTMLPDF 等格式,也可以轻松复制内容及格式到 word邮件 中。

    (二)为什么要使用 Markdown

    格式清晰,读起来很舒服
    语法简洁,编写时可以更专注于内容而非排版格式
    纯文本形式,兼容所有的文本编辑器,如word,txt
    可导出 HTML、PDF 等常见格式

    目前来看,支持 Markdown 语法的编辑器有很多,包括很多网站(例如简书)也支持了 Markdown 的文字录入。Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式,这种格式写出的简历更能得到 HR 的好感。甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台 Tumblr,也支持 Mou 这类 Markdown 工具的直接上传 [转自简书]

    (三)如何使用 Markdown

    Markdown 的语法非常简单,主要包含以下几个部分:
    标题段落列表强调区块引用代码区块行内代码分割线链接自动链接图片反斜杠表格(扩展)

    1. 标题

    在你的标题前添加 #
    添加一个 # 为一级标题,两个为二级标题,以此类推,最多可至六级标题,如
    # 一级标题
    ## 二级标题
    ###### 六级标题

    效果为

    一级标题

    二级标题

    六级标题

    2. 段落

    Markdown中的段落顶格开头
    因为Markdown语法中会自动消除多余的空格和换行来保证整洁性,段与段落之间最多只有一个空行,字与字之间最多只有一个空格
    Markdown语法中其实规定有所不同,但当前的Markdown编辑器都对其段落书写进行了优化,变得更加智能合理,所以在这不再赘述旧的规定。

    3. 列表

    Markdown 支持无序列表和有序列表。无序列表使用星号* 、加号+减号-
    加至少一个空格或一个制表符(Tab)作为列表标记,如

    * 第一项
    * 第二项
    * 第三项

    效果为

    • 第一项
    • 第二项
    • 第三项

    有序列表使用数字加点. 再加至少一个空格或制表符作为列表标记,如

    1. 第一项
    2. 第二项
    3. 第三项

    效果为

    1. 第一项
    2. 第二项
    3. 第三项

    4. 强调

    内容前后加上 星号*下划线_ 表示 强调。前后加一个星号或下划线为 斜体,两个为 粗体,三个为 粗斜体。如
    *斜体*
    **粗体**
    ***粗斜体***

    效果为

    斜体
    粗体
    粗斜体

    5. 区块引用

    在段落的 第一行或每行开头 使用 > 表示引用,多个 > 表示嵌套,如
    >区块引用
    >>嵌套引用

    效果为

    区块引用

    嵌套引用

    6. 代码区块

    上下分别用三个反引号(键盘最左上角)```包围的区域, 表示代码块,如:
    ```
    int main(){
    printf("hello world\n");
    return 0;
    }
    ```
    效果为:

      int main(){
         printf("hello world\n");
         return 0;
      }
    

    7. 行内代码

    前后含 反引号( ` ) 的内容为行内代码,也可以用来表示内容中的小标注,如

    语句`System.out.println("Hello, world")` 表示输出"Hello, world"。

    效果为

    语句System.out.println("Hello, world") 表示输出”Hello, world”。

    8. 分割线

    三个或三个以上的星号 *、减号 -或下划线 _表示 分割线,中间可插入空格,如
    ***
    或 - - - --
    效果为



    9. 链接

    Markdown 支持两种形式的链接,行内式参考式。二者差别不大,前者更方便一些,这里只讲述常用的行内式。
    行内式 的链接文字用中括号 [] 标记title,方括号后紧接小括号 ()标记网址链接,如:
    [GitHub](https://github.com/)
    效果为

    GitHub

    10. 自动链接

    Markdown 支持以 简短的自动链接 形式处理网址和电子邮箱,用尖括号 <>
    标记,如:
    <https://github.com>
    效果为

    https://github.com

    不过目前大部分Markdown编辑器开始支持自动识别地址链接,这一语法变得不是特别常用。

    11. 图片

    Markdown 中标记图片的方式与标记链接类似,只需在链接文字的标记前加一个感叹号 !
    ,如
    ![GitHub Icon](http:https://img.haomeiwen.com/i6802002/25055e48f80cbadb.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

    效果为


    GitHub Icon

    部分 Markdown 编辑器不支持指定图片的宽高,调节其宽高的方式简单的有两种:
    1.通过调节URL最后方的参数来调节其宽度(如上图的w/1240,实际显示效果我调整为了w/240 进行了图片的缩放)
    2.Markdown中支持部分html语法,可以通过插入的html进行修改 参考链接

    12. 反斜杠转义符

    通过反斜杠 \转义符
    可插入一些在 Markdown 语法中有其他意义的符号,如
    \*前后为星号\*
    效果为

    *前后为星号*

    Markdown 支持在以下符号前加反斜杠 \ 来帮助插入普通的符号:

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

    13. 表格(扩展)

    表格为 扩展 的 Markdown 语法,
    | 表示纵向的边界,
    表头和内容之间用 三个或三个以上减号 - 隔开
    可以使用冒号 : 设置 对齐方式
    冒号 :在左边表示左对齐,在右边表示右对齐,两边都有冒号 :表示居中,不使用冒号 :时默认 左对齐,如

    | character | action | target |
    | ----- |:-------:| -----:|
    | i | miss | you |
    | you | believe | me |

    效果为:

    character action target
    i miss you
    you believe me

    14.其他

    还有一些不是很常用的Markdown语法贴在这里,与编辑器有关,部分支持,留个位置,日后遇到了有用的更新在这里。

    名字 语法 效果
    删除线 ~text~ text
    ... ... ...

    (四)Markdown 编辑器

    Mac 下好用的 Markdown 编辑器有很多,如 MacDownMouTypora 等。
    Windows 下可以使用 MarkdownPad马克飞象有道云笔记 等。

    参考链接:
    Markdown简明教程-智学院
    Markdown——入门指南-简书

    相关文章

      网友评论

      本文标题:MarkDown语法教程

      本文链接:https://www.haomeiwen.com/subject/nfhflxtx.html