Markdown语法

作者: Q琴酒 | 来源:发表于2016-08-15 17:37 被阅读47次

    本文主要内容包括:markdwon的基本语法和使用技巧。

    相关文档


    概述


    宗旨

    易读易写

    编辑工具

    • Mou
      Mac OS X 系统可以使用,支持实时预览功能
    • Atom
      多端可以使用,就是效率很低。有时候很卡。
    • 简书
      Web端使用简书编辑也是不错的选择。可以保存在云端。

    兼容 HTML

    • 区块元素(<div> <table> <pre> <p>)
      这是一个普通的段落。
      <table>
        <tr>
          <td>*Hello*</td>
          <td>Word</td>
        </tr>
      </table>
      这是另外一个段落。
      
      这是一个普通的段落。
      <table><tr><td>Hello</td><td>Word</td></tr></table>
      这是另外一个段落。
    • HTML 区块标签间的 Markdown 格式语法将不会被处理
    • 行内标签(<span> <cite> <del>)可以随意使用
    • <a> <img>可以直接使用
    <a href="http://www.baidu.com">百度</a>
    

    <a href="http://www.baidu.com">百度</a>

    • 特殊字符自动转换
        AT&T
        ©
      
      AT&T
      ©

    基本符号


    • *,-,+ 3个符号效果都一样,这3个符号被称为Markdown符号
    • 空白行表示另起一个段落
    • `是表示inline代码,tab是用来标记 代码段,分别对应html的code,pre标签

    区块元素


    段落和换行

    段落是由前后一个以上的空行产生的,普通段落不该用空格或制表符来缩进。

    标题

    • Setext 形式

      这是 H1
      =============
      这是 H2
      -------------
      
    • atx 形式

      # 这是 H1
      ## 这是 H2
      ###### 这是 H6
      

    区块引用 Blockquotes

    > 这是一个区块引用
      Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >
    >> 区块引用可以嵌套
    >>> 区块引用可以嵌套  
    >>> - 这是第一行列表项。
    >>> - 这是第二行列表项。
    
    >> 区块引用可以嵌套
    
    > 区块引用可以嵌套
    

    这是一个区块引用
    Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >

    区块引用可以嵌套

    区块引用可以嵌套

    • 这是第一行列表项。
    • 这是第二行列表项。

    区块引用可以嵌套

    区块引用可以嵌套

    列表

    无序列表使用星号、加号或是减号作为列表标记:

      *   Red
      -   Green
      +   Blue  
    
    • Red
    • Green
    • Blue

    有序列表则使用数字接着一个英文句点

    1. Bird  
      第二段  
      第三段
    
    2. McHale
      > 这是一个区块引用
      > 这是一个区块引用
    3. Parish
    4. 一列表项包含一个列表区块:  
      <代码写在这>
    1986. 有序列表前面的序号不起作用
    1986\. 避免这种`数字-句点-空白`生成列表
    
    1. Bird
      第二段
      第三段

    2. McHale

    这是一个区块引用
    这是一个区块引用

    1. Parish
    2. 一列表项包含一个列表区块:
      代码写在这
    3. 有序列表前面的序号不起作用
      1986. 避免这种数字-句点-空白生成列表

    代码区块

    markdwon语法

    缩进 4 个空格或是 1 个制表符

    这是一个普通段落:
    
        这是一个代码区块。
    
          import java.io.*;
    

    这是一个普通段落:

    这是一个代码区块。

    import java.io.*;
    <div class="footer">
      © 2004 Foo Corporation
    </div>  
    
      `这是一个代码区块`
    

    这是一个代码区块

    <pre>
    '''
    这是一个代码区块
    '''
    </pre>

      这是一个代码区块
    
    html方式

    <pre> <code>

    分隔线

      ***
      * * *
      ---
      - - -
    




    表格(扩展的markdown才支持)

    注意冒号是对齐方式

    | Tablees    | Are           | Coll  |
    | ----------:|:-------------:|:------|
    | col 3 is   | right-aligned | $160  |
    | col 2 is   | centered      | $12   |
    | col 2 is   | centered      | $12   |
    
    Tablees Are Coll
    col 3 is right-aligned $160
    col 2 is centered $12
    col 2 is centered $12

    流程图

    参考

      st=>start: Start
      i=>inputoutput: 输入年份n
      cond1=>condition: n能否被4整除?
      cond2=>condition: n能否被100整除?
      cond3=>condition: n能否被400整除?
      o1=>inputoutput: 输出非闰年
      o2=>inputoutput: 输出非闰年
      o3=>inputoutput: 输出闰年
      o4=>inputoutput: 输出闰年
      e=>end
      st->i->cond1
      cond1(no)->o1->e
      cond1(yes)->cond2
      cond2(no)->o3->e
      cond2(yes)->cond3
      cond3(yes)->o2->e
      cond3(no)->o4->e
    

    插入LaTeX公式

    参考

    • 使用MathJax引擎
    <script type="text/javascript"  
            src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default">
    </script>
    

    使用Tex写公式。$$公式$$表示行间公式,本来Tex中使用(公式)表示行内公式,但因为Markdown中\是转义字符,所以在Markdown中输入行内公式使用\(公式\),如下代码:

      $$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
      \\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\)
    

    $$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
    \(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\)

    区段元素


    强调

    *斜体* _斜体_
    **粗体** __粗体__
    ~~删除线~~
    <u>下划线</u>
    上标<sup>2</sup>
    下标<sub>2</sub>
    

    斜体 斜体
    粗体 粗体
    删除线
    <u>下划线</u>
    上标2
    下标2

    链接

    • 行内式

      这是一个[行内式的链接](http://tech.xchance.xyz "可选的title")
      这是一个[相对路径的连链接](/about "可选的title")
      

      这是一个行内式的链接
      这是一个相对路径的连链接

    • 参考式
      这是一个[参考式的连接] [1]
      [1]: http://tech.xchance.xyz "Github 个人主页"
      [2]: <http://tech.xchance.xyz> "Github 个人主页"
      [3]: http://tech.xchance.xyz 'Github 个人主页'
      [4]: http://tech.xchance.xyz (Github 个人主页)
      参考式的连接
      隐式链接标记:[Google Address][]
      [Google Address]: http://google.com/

      [Google Address][]
      [Google Address]: http://google.com/
      [id]: http://tech.xchance.xyz

    • 简写Url

      <http://tech.xchance.xyz>
      <catchance@163.com>
      

      http://tech.xchance.xyz
      catchance@163.com

    图片

    类似链接方式同样支持行内式参考式<img>
    hexo好像不支持可选文字

      ![Alt text](http://tech.xchance.xyz/favicon.ico)
      ![Alt text](http://tech.xchance.xyz/favicon.ico)
      ![Alt text][id]
      [id]: url/to/image  "Optional title attribute"
    
    Alt textAlt text
    Alt textAlt text

    注脚

    原始Markdown语法好像不支持,不过有些Blog是支持的

      这是一个注脚[^footer]
      [^footer]: 这是一个注脚
    

    这是一个注脚 [1]

    页内跳转

      定义锚点: <span id="jump"> hello world </span>
      使用锚点: [hello](#jump)
    

    定义锚点: <span id="jump"> hello world </span>
    使用锚点: hello

    技巧


    • 使用两个以上的空格然后回车插入<br /> 标签
    • 特殊字符需要\字符来转义:
      \ ` * _ {} [] () # + - . !
    • 如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段
      代码块中插入反引号:`` ` ``
    

    代码块中插入反引号:`

    • 段首缩进技巧:
      切换到全角模式下(一般的中文输入法都是按 shift + space)输入两个空格就行了
    • 文章中插入注释的话,可以使用``

    名词解释


    <span id ="ref1">空行</span> 显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行


    1. 这是一个注脚

    相关文章

      网友评论

        本文标题:Markdown语法

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