Markdown语法

作者: Zhang21 | 来源:发表于2017-09-05 14:53 被阅读78次

    看了简书的 为什么作家应该用 Markdown 保存自己的文稿 后,改用Markdown,但简书的Markdown好像暂不支持 公式 和 流程图!


    关于Markdown

    Markdown 是一种轻量级标记语言。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。

    参考文件

    Markdown-wiki
    Markdown官网
    Markdown中文文档
    Markdown语法

    Markdown语法

    首行缩进

    #一个空格
      
    
    #两个空格
     
    
    #不断行空白格
     
    

    栗子:

    1.  一个空格;
    2.  两个空格;
    3.  不断行空白格;

    段落与换行

    • 段落的前后必须是空行
      空行是指行内什么都没有,或者只有空白符(空格或制表符)
      相邻两行文本,如果中间没有空行,会显示在一行中(换行符被转换为空格)
    • 如果需要在段内加入换行

      可以在前一行的末尾加入至少两个空格,然后换行写其它的文字
    • Markdown中的多数区块都需要在两个空行之间

    粗体和斜体

    语法:

    *斜体*, _斜体_
    **粗体**
    ***粗斜体***
    ~~删除线~~
    

    显示效果:

    • 斜体, 斜体
    • 粗体
    • 粗斜体
    • 删除线

    分级标题

    Setext形式

    大标题:

    一级大标题
    ========
    
    二级大标题
    --------
    

    效果:

    一级大标题

    二级大标题

    atx形式

    普通标题:

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    

    显示效果

    一级标题

    二级标题

    三级标题

    超链接

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

    行内式

    语法说明:
    [ ] 里面写链接文字,( ) 里面写链接地址,()中的" "可以指定title属性。

    代码:
    欢迎来到 [简书](www.jianshu.com "Jianshu")
    效果:
    欢迎来到 简书

    参考式

    参考式超链接一般用在学术论文上面,或某一个链接在文章中多处使用,那么引用的方式创建链接将非常好,它可以让你对链接进行统一的管理。
    语法说明:

    参考式链接分为两部分,文中的写法[链接文字][链接标记],在文本任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格
    如果链接文字本身可以作为链接标记,也可以写成[链接文字][]
    [链接文字]:链接地址的形式
    

    代码:

    简书里面有 [简书早报][1]、[简书晚报][2]以及 [简黛玉][3]
    [简黛玉 美人][3] 是一个[才女][]
    [1]:http://www.jianshu.com "Jianshu"
    [2]:http://www.jianshu.com "EveningPaper"
    [3]:http://www.jianshu.com
    [才女]:http://www.jianshu.com
    

    效果:

    简书里面有 简书早报简书晚报以及简黛玉
    简黛玉 美人 是一个才女

    自动链接

    MarkDown支持以比较简短的自动链接形式来处理网址和电子邮件,只要用<>包起来,MarkDown就会自动把它转成链接。
    代码:

    <http://example.com>
    <address@example.com>
    

    显示效果:
    http://example.com
    address@example.com

    锚点

    网页中,锚点其实就是网页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如返回顶部
    注意:

    MarkDown Extra只支持在标题后插入锚点,其他地方无效;
    Leanote编辑器右侧显示效果区域暂时不支持锚点跳转,所以点来点去发现没有跳转不必惊慌,你发布后的文章是支持的;
    在你准备跳转到的指定标题后插入锚点{#标记},然后在其他地方写上连接到锚点的链接

    代码:

    目录{#index}
    跳转到 [目录](#index)
    

    效果:
    目录{#index}
    跳转到 目录

    列表

    无序列表

    使用 * ,+ ,- 表示无序列表
    代码:

    - 无序列表1
    - 无序列表2
    - 无序列表3
    

    效果:

    • 无序列表1
    • 无序列表2
    • 无序列表3

    有序列表

    有序列表使用数字接着英文点
    代码:

    1. 有序列表1
    2. 有序列表2
    3. 有序列表3
    

    效果:

    1. 有序列表1
    2. 有序列表2
    3. 有序列表3

    定义型列表

    定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
    代码:

    MarkDown
    :    轻量级文本标记语言,可以转换成html、pdf等格式(注意一个冒号和一个Tab)
    
    代码块 2
    :    这是代码块的定义
    
            代码块(左侧有八个空格)
    

    列表缩进

    列表项目标记通常是放在最左边,但是其实也可以缩进,最多3个空格,项目标记后则一定要接着至少一个空格或制表符。
    代码:

    *    轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
    那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
    *    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
    

    效果:

    • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
      那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
    • 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。

    引用

    引用需要在被引用的文本前加上 > 符号
    代码:

    > 引用1
    > 引用2
    

    效果:

    引用1
    引用2

    引用的多层嵌套

    区块引用可以嵌套(如引用的引用),只要根据层次加上不同数量的 >符号
    代码:

    >>> 请问MarkDown怎么用?
    >> 自己看教程!
    > 教程在哪里?
    

    效果:

    请问MarkDown怎么用?

    自己看教程!

    教程在哪里?

    插入图像

    图片的创建方式与超链接类似。
    代码:
    [图片上传失败...(image-8a94bb-1512008355179)]

    内容目录

    在段落中填写 [TOC] 以显示全文内容结构目录

    注脚

    在需要添加注脚的文字后加上注脚名字 [^注脚名字],称为加注。然后在文中的任意位置(一般最后)添加脚注,脚注前必须有对应的脚注名字。
    注脚与注脚间必须空一行!
    注脚自动被搬运到最后面,请到文章末尾查看,并且脚注后的链接可以直接跳转会到加注的地方
    代码:

    使用 MarkDown[^1]可以提高书写效率,直接转换成 HTML[^2]
    [^1]:MarkDown是一种纯文本标记语言
    [^2]:HTML超文本标记语言
    

    效果:
    使用 MarkDown[1]可以提高书写效率,直接转换成 HTML[2]

    分割线

    可以在一行中用 三个以上的 *,-,_ 建立一个分割线,行内不能有其他东西。
    ** 代码: **

    1. * * * *
    2.
    3. ****
    4.
    5. - - - -
    6.
    7. --------
    

    效果:





    扩展语法

    Markdown标准 本身所包含的功能有限,所以产生了许多第三方扩展语法,如 GFW, GitHub Flavored Markdown

    Tasklist

    代码:

    - [ ] Monday
    - [ ] Tuesday
    - [ ] Wednesday
    - [ ] Tuesday
    - [ ] Friday
    

    效果:

    • [ ] Monday
    • [ ] Tuesday
    • [ ] Wednesday
    • [ ] Tuesday
    • [ ] Friday

    表格

    1. 不管是哪种方式,第一行为表头,第二行为分割表头和主体部分,第三行开始每一行为一个表格行;
    2. 列与列之间用管道符号 | 隔开;
    3. 第二行还可以为不同的列指定对其方向,默认左对齐,在 - 右边加上 : 就右对齐

    代码:

    学号 | 姓名 | 分数
    - | - | -
    001 | 张三 | 78
    002 | 李四 | 67
    003 | 王五 | 99
    
    学号 姓名 分数
    001 张三 78
    002 李四 67
    003 王五 99

    代码块和高亮

    代码块

    插入代码的方式有两种,一种是利用缩进(Tab),另一种是利用反引号 `` 和 ``` ```
    代码:

    Python语言的输出函数 `Print()` 怎么使用?
    

    效果:
    Python语言的输出函数 Print() 怎么使用?

    import os
    from flask import Flask
    app = Flask(app)
    

    高亮

    在 ``` 之后添加代码的语言
    代码:
    ```python
    import os
    from flask import Flask
    app = Flask(app)
    ```

    效果:

    import os
    from flask import Flask
    app = Flask(app)
    

    流程图

    ** 流程图语法参考 **

    LaTeX公式

    关于LaTEX:

    是一种跨平台的基于TEX的排版系统,对于生成复杂表格和数学公式,这一点表现得尤为突出。
    因此它非常适用于生成高印刷质量的科技和数学、化学类文档。

    关于MathJax:

    MathJax是一种跨浏览器JavaScript库,它使用MathML,LaTeX和ASCIIMathML 标记在Web浏览器中显示数学符号。
    MathJax作为Apache License下的开源软件。

    MathJax语法

    语法

    $表示行内公式
    质能守恒公式 $E=mc^2$ 方程式
    效果:$E=mc^2$

    $$表示整行公式
    代码:

    $$\sum_{i=1}^n a_i=0$$
    
    $$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
    
    $$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$
    

    效果:
    $$\sum_{i=1}^n a_i=0$$

    $$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

    $$\sum^{j-1}{k=0}{\widehat{\gamma}{kj} z_k}$$

    Markdown编辑器

    介绍一些常用的书写、编辑Markdown的工具。

    • MarkdownPad Windows (windows)
    • Texts (Windows, osX)
    • MarkPad (Windows)
    • Haroopad (Windows, osX, Linux)
    • ReText (Linux)
    • 等等;

    格式转换

    Markdown文档可以方便地转换为 HTML, Word, PDF 等文件格式。
    可以利用 软件 或者 命令 转换文件。

    转换为 HTML

    转换为 PDF

    转换为 Word




    1. MarkDown是一种纯文本标记语言

    2. HTML超文本标记语言

    相关文章

      网友评论

        本文标题:Markdown语法

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