Markdown 语法整理大集合2017

简明教程:https://ouweiya.gitbooks.io/markdown/javascript


1.标题

代码html

注:# 后面保持空格java

# h1
## h2
### h3
#### h4
##### h5
###### h6
####### h7      // 错误代码
######## h8     // 错误代码
######### h9    // 错误代码
########## h10  // 错误代码

演示git

h1

h2

h3

h4

h5
h6

####### h7
######## h8
######### h9
########## h10github


2.分级标题

代码
注:= - 最少能够只写一个,兼容性通常web

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

演示markdown


3.TOC

注:根据标题生成目录,兼容性通常app

代码框架

[TOC]

演示工具


4.引用

代码1(单行式)

> hello world!

演示

hello world!

代码2(多行式)

> hello world!
hello world!
hello world!

或者

> hello world!
> hello world!
> hello world!

演示

相同的结果

hello world!
hello world!
hello world!

代码3(多层嵌套)

> aaaaaaaaa
>> bbbbbbbbb
>>> cccccccccc

演示

aaaaaaaaa

bbbbbbbbb

cccccccccc


5.行内标记

注:用 ` 标记代码块将变成一行

代码

标记以外`hello world`标记以外

演示

标记以外hello world标记以外

错误代码
注:不一样平台错误略有差别

标记以外 ` 
< div>   
    < div></div>
    < div></div>
    < div></div>
< /div>
`标记以外

演示


6.代码块

注:与上行距离一空行

代码1(```)

注:用```生成块

```
<div>   
    <div></div>
    <div></div>
    <div></div>
</div>
```

演示

<div>   
    <div></div>
    <div></div>
    <div></div>
</div>

代码2(Tab)

注: Tab缩进

我是文字……
&lt;div&gt;   
    &lt;div&gt;&lt;/div&gt;
    &lt;div&gt;&lt;/div&gt;
    &lt;div&gt;&lt;/div&gt;
&lt;/div&gt;
&lt;div&gt; &lt;div&gt;&lt;/div&gt; &lt;div&gt;&lt;/div&gt; &lt;div&gt;&lt;/div&gt; &lt;/div&gt;

演示

<div>   
    <div></div>
    <div></div>
    <div></div>
</div>

代码3(自定义语法)
注:根据不一样的语言配置不一样的代码着色

```javascript
var num = 0;
for (var i = 0; i < 5; i++) {
    num+=i;
}
console.log(num);
```

演示

var num = 0;
for (var i = 0; i < 5; i++) {
    num+=i;
}
console.log(num);

7.插入连接

代码1(内链式)
注:{:target="_blank"}跳转方式兼容性通常 ,多数第三方平台不支持跳转

[百度1](http://www.baidu.com/" 百度一下"){:target="_blank"}

演示

百度1

代码2(引用式)

[百度2][2]{:target="_blank"}
[2]: http://www.baidu.com/   "百度二下"

演示

百度2


8.插入图片

代码1(内链式)

[图片上传失败...(image-90880b-1542510791300)]

演示

代码2(引用式)

![name][01]
[01]: ./01.png '描述'

演示


9.插入图片带有连接

代码

[[图片上传失败...(image-f83b77-1542510791300)]](http://www.baidu.com){:target="_blank"} // 内链式[[图片上传失败...(image-4dc956-1542510791300)]][5] // 引用式 [5]: http://www.baidu.com

演示

[

][5]
[5]: http://www.baidu.com


10.视频插入

注:Markdown 语法是不支持直接插入视频的
广泛的作法是 插入HTML的 iframe 框架,经过网站自带的分享功能获取,若是没有能够尝试第二种方法
第二是伪造播放界面,实质是插入视频图片,而后经过点击跳转到相关页面

代码1
注:多数第三方平台不支持插入<iframe>视频

youku
<iframe height=498 width=510 src='http://player.youku.com/embed/XMjgzNzM0NTYxNg==' frameborder=0 'allowfullscreen'></iframe>

演示

代码2

[[图片上传失败...(image-49aefe-1542510791300)]](http://v.youku.com/v_show/id_XMjgzNzM0NTYxNg==.html?spm=a2htv.20009910.contentHolderUnit2.A&from=y1.3-tv-grid-1007-9910.86804.1-2#paction){:target="_blank"}

演示


11.序表

代码1(有序)

注:序列.后 保持空格

1. one
2. two
3. three

演示

  1. one
  2. two
  3. three

代码2(无序)

* one
* two
* three

演示

  • one
  • two
  • three

代码3(序表嵌套)

1. one
    1. one-1
    2. two-2
2. two 
    * two-1
    * two-2

演示

  1. one
    1. one-1
    2. two-2
  2. two
    • two-1
    • two-2

代码4(序表嵌套代码块)
注:换行+两个Tab

* one
var a = 10;     // 与上行保持空行并 递进缩进
var a = 10; // 与上行保持空行并 递进缩进

演示:

  • one

    var a = 10;

12.任务列表

注:兼容性通常 要隔开一行

代码

  
  
  
  
这是文字……
  • 选项一
  • 选项二
  • [选项3]
  • 演示


    13.表情

    注:兼容通常

    表情代码地址


    14.表格

    注: : 表明对齐方式 ,** :| 之间不要有空格**,不然对齐会有些不兼容

    代码1

    |    a    |       b       |      c     |
    |:-------:|:------------- | ----------:|
    |   居中  |     左对齐    |   右对齐   |
    |=========|===============|============|

    演示

    a b c
    居中 左对齐 右对齐
    ========= =============== ============

    代码2(简约写法)

    a  | b | c  
    :-:|:- |-:
        居中    |     左对齐      |   右对齐    
    ============|=================|=============

    演示

    a b c
    居中 左对齐 右对齐
    ============ ================= =============

    代码3(特殊表格)

    注:通常对合并单元格,以及其余特殊格式表格,markdown 是无能为力的
    因此常规的作法是使用HTML标签,可是这样的编写效率极低。
    可是有了这款工具的话,全部问题都迎刃而解。

    在线生成HTML代码 Tables Generator (国外的站)

    Tables Generator

    演示


    15.支持内嵌CSS样式

    代码

    <p style="color: #AD5D0F;font-size: 30px; font-family: '宋体';">内联样式</p>

    演示


    16.语义标记

    描述 效果 代码
    斜体 斜体 *斜体*
    斜体 斜体 _斜体_
    加粗 加粗 **加粗**
    加粗+斜体 加粗+斜体 ***加粗+斜体***
    加粗+斜体 加粗+斜体 **_加粗+斜体_**
    删除线 删除线 ~~删除线~~

    17.语义标签

    描述 效果 代码
    斜体 <i>斜体</i> <i>斜体</i>
    加粗 <b>加粗</b> <b>加粗</b>
    强调 <em>强调</em> <em>强调</em>
    上标 Za Z<sup>a</sup>
    下标 Za Z<sub>a</sub>
    键盘文本
    <kbd>Ctrl</kbd>
    换行

    18.格式化文本

    保持输入排版格式不变
    注:对内含标签须要破坏结构才能显示

    代码

    <pre>
    hello world 
             hi
      hello world 
    </pre>

    演示

    <pre>
    hello world
    hi
    hello world
    </pre>

    错误解决方法
    注:标签内部添加空格 或者 直接使用```标记来处理
    代码1(插入空格)

    <pre>
        < div>   
            < div>< /div>
            < div>< /div>
            < div>< /div>
        < /div>
    </pre>

    演示

    <pre>
    < div>
    < div>< /div>
    < div>< /div>
    < div>< /div>
    < /div>
    </pre>

    代码2( ``` 代码块标记)

    ```
    <div>   
        <div></div>
        <div></div>
        <div></div>
    </div>
    ```

    演示

    <div>   
        <div></div>
        <div></div>
        <div></div>
    </div>

    19.公式 {#1}

    注:1个$左对齐,2个居中

    代码

    $$ x \href{why-equal.html}{=} y^2 + 1 $$
    $ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $

    演示


    20.分隔符

    注:最少三个 ---**** * *

    代码

    ***
    ---
    * * *

    演示




    21.脚注

    代码

    Markdown[^1]
    [^1]: Markdown是一种纯文本标记语言        // 在文章最后面显示脚注

    演示

    Markdown[1]


    22.锚点

    代码
    注:只有标题支持锚点, 跳转目录方括号后 保持空格

    [公式标题锚点](#1)

    [须要跳转的目录] {#1} // 方括号后保持空格

    演示

    公式标题锚点


    23.定义型列表

    注:解释型定义
    代码

    Markdown : 轻量级文本标记语言,能够转换成html,pdf等格式 // 开头一个`:` + `Tab` 或 四个空格
    代码块定义

    代码块定义……

    var a = 10;         // 保持空一行与 递进缩进
    
    var a = 10; // 保持空一行与 递进缩进

    演示


    24.自动邮箱连接

    代码

    <xxx@outlook.com>

    演示

    xxx@outlook.com


    25.流程图

    代码1

    ```flow // 流程 st=>start: 开始|past:> http://www.baidu.com // 开始 e=>end: 结束 // 结束 c1=>condition: 条件1:>http://www.baidu.com[_parent] // 判断条件 c2=>condition: 条件2 // 判断条件 c3=>condition: 条件3 // 判断条件 io=>inputoutput: 输出 // 输出 //----------------以上为定义参数-------------------------

    //----------------如下为链接参数------------------------- // 开始->判断条件1为no->判断条件2为no->判断条件3为no->输出->结束 st->c1(yes,right)->c2(yes,right)->c3(yes,right)->io->e c1(no)->e // 条件1不知足->结束 c2(no)->e // 条件2不知足->结束 c3(no)->e // 条件3不知足->结束

    </code></pre>
    <p><strong>演示</strong></p>
    <div class="image-package">
    <div class="image-container" style="max-width: 635px; max-height: 281px; background-color: transparent;">
    <div class="image-view" data-width="635" data-height="281"><img data-original-src="//upload-images.jianshu.io/upload_images/6912209-972af6417eb7db1e.png" data-original-width="635" data-original-height="281" data-original-format="" data-original-filesize="13858" class="" data-image-index="18" style="cursor: zoom-in;" src="//upload-images.jianshu.io/upload_images/6912209-972af6417eb7db1e.png?imageMogr2/auto-orient/strip|imageView2/2/w/635/format/webp"></div>
    </div>
    <div class="image-caption"></div>
    </div>
    <p><strong>代码详解</strong><br>
    流程图分为两个部分: <strong>定义参数</strong> 而后 <strong>链接参数</strong></p>
    <p><strong>定义示例:</strong></p>
    <pre><code>tag=&gt;type: content:&gt;url         // 形参格式 
    st=&gt;start: 开始:&gt;http://www.baidu.com[blank]  //实参格式
    </code></pre>
    <p>注:** <code>st=&gt;start: 开始</code> 的<code>:</code>后面保持空格**</p>
    <table>
    <thead>
    <tr>
    <th>形参</th>
    <th>实参</th>
    <th>含义</th>
    </tr>
    </thead>
    <tbody>
    <tr>
    <td>tag</td>
    <td>st</td>
    <td>标签 (能够自定义)</td>
    </tr>
    <tr>
    <td>=&gt;</td>
    <td>=&gt;</td>
    <td>赋值</td>
    </tr>
    <tr>
    <td>type</td>
    <td>start</td>
    <td>类型  (6种类型)</td>
    </tr>
    <tr>
    <td>content</td>
    <td>开始</td>
    <td>描述内容 (能够自定义)</td>
    </tr>
    <tr>
    <td>:&gt;url</td>
    <td><code>http://www.baidu.com[blank]</code></td>
    <td>连接与跳转方式 <strong>兼容性不好</strong>
    </td>
    </tr>
    </tbody>
    </table>
    <table>
    <thead>
    <tr>
    <th>6种类型</th>
    <th>含义</th>
    </tr>
    </thead>
    <tbody>
    <tr>
    <td>start</td>
    <td>启动</td>
    </tr>
    <tr>
    <td>end</td>
    <td>结束</td>
    </tr>
    <tr>
    <td>operation</td>
    <td>程序</td>
    </tr>
    <tr>
    <td>subroutine</td>
    <td>子程序</td>
    </tr>
    <tr>
    <td>condition</td>
    <td>条件</td>
    </tr>
    <tr>
    <td>inputoutput</td>
    <td>输出</td>
    </tr>
    </tbody>
    </table>
    <p><strong>链接示例:</strong></p>
    <pre><code>st-&gt;c1(yes,right)-&gt;c2(yes,right)-&gt;c3(yes,right)-&gt;io-&gt;e
    开始-&gt;判断条件1为no-&gt;判断条件2为no-&gt;判断条件3为no-&gt;输出-&gt;结束
    </code></pre>
    <table>
    <thead>
    <tr>
    <th>形参</th>
    <th>实参</th>
    <th>含义</th>
    </tr>
    </thead>
    <tbody>
    <tr>
    <td>-&gt;</td>
    <td>-&gt;</td>
    <td>链接</td>
    </tr>
    <tr>
    <td>condition</td>
    <td>c1</td>
    <td>条件</td>
    </tr>
    <tr>
    <td>(布尔值,方向)</td>
    <td>(yes,right)</td>
    <td>若是知足向右链接,4种方向:right ,left,up ,down 默认为:down</td>
    </tr>
    </tbody>
    </table>
    <p>注:operation (程序); subroutine (子程序) ;condition (条件),均可以在括号里加入链接方向。</p>
    <pre><code>operation(right) 
    subroutine(left)
    condition(yes,right)    // 只有条件 才能加布尔值
    </code></pre>
    <hr>
    <p><strong>代码2</strong></p>
    <p>注:添加样式和url跳转 须要添加第三方的脚本<br>
    实际效果不好,使用起来麻烦,意义不大</p>
    <pre><code>```flow                             // 流程
    st=&gt;start: 启动|past:&gt;http://www.baidu.com[blank] // 开始
    e=&gt;end: 结束                      // 结束
    op1=&gt;operation: 方案一             // 运算1
    sub2=&gt;subroutine: 方案二|approved:&gt;http://www.baidu.com[_parent]  // 运算2
    sub3=&gt;subroutine: 从新制定方案        // 运算2
    cond1=&gt;condition: 行不行?|request  // 判断条件1
    cond2=&gt;condition: 行不行?          // 判断条件2
    io=&gt;inputoutput: 结果满意           // 输出
    
    // 开始-&gt;方案1-&gt;判断条件-&gt;
    st-&gt;op1-&gt;cond1
    // 判断条件1为no-&gt;方案2-&gt;判断条件2为no-&gt;从新制定方案-&gt;方案1
    cond1(no,right)-&gt;sub2-&gt;cond2(no,right)-&gt;sub3(right)-&gt;op1
    cond1(yes)-&gt;io-&gt;e       // 判断条件知足-&gt;输出-&gt;结束
    cond2(yes)-&gt;io-&gt;e       // 判断条件知足-&gt;输出-&gt;结束
    
    </code></pre> <p><strong>演示</strong></p> <div class="image-package"> <div class="image-container" style="max-width: 635px; max-height: 281px; background-color: transparent;"> <div class="image-view" data-width="635" data-height="281"><img data-original-src="//upload-images.jianshu.io/upload_images/6912209-972af6417eb7db1e.png" data-original-width="635" data-original-height="281" data-original-format="" data-original-filesize="13858" class="" data-image-index="18" style="cursor: zoom-in;" src="//upload-images.jianshu.io/upload_images/6912209-972af6417eb7db1e.png?imageMogr2/auto-orient/strip|imageView2/2/w/635/format/webp"></div> </div> <div class="image-caption"></div> </div> <p><strong>代码详解</strong><br> 流程图分为两个部分: <strong>定义参数</strong> 而后 <strong>链接参数</strong></p> <p><strong>定义示例:</strong></p> <pre><code>tag=&gt;type: content:&gt;url // 形参格式 st=&gt;start: 开始:&gt;http://www.baidu.com[blank] //实参格式 </code></pre> <p>注:** <code>st=&gt;start: 开始</code> 的<code>:</code>后面保持空格**</p> <table> <thead> <tr> <th>形参</th> <th>实参</th> <th>含义</th> </tr> </thead> <tbody> <tr> <td>tag</td> <td>st</td> <td>标签 (能够自定义)</td> </tr> <tr> <td>=&gt;</td> <td>=&gt;</td> <td>赋值</td> </tr> <tr> <td>type</td> <td>start</td> <td>类型 (6种类型)</td> </tr> <tr> <td>content</td> <td>开始</td> <td>描述内容 (能够自定义)</td> </tr> <tr> <td>:&gt;url</td> <td><code>http://www.baidu.com[blank]</code></td> <td>连接与跳转方式 <strong>兼容性不好</strong> </td> </tr> </tbody> </table> <table> <thead> <tr> <th>6种类型</th> <th>含义</th> </tr> </thead> <tbody> <tr> <td>start</td> <td>启动</td> </tr> <tr> <td>end</td> <td>结束</td> </tr> <tr> <td>operation</td> <td>程序</td> </tr> <tr> <td>subroutine</td> <td>子程序</td> </tr> <tr> <td>condition</td> <td>条件</td> </tr> <tr> <td>inputoutput</td> <td>输出</td> </tr> </tbody> </table> <p><strong>链接示例:</strong></p> <pre><code>st-&gt;c1(yes,right)-&gt;c2(yes,right)-&gt;c3(yes,right)-&gt;io-&gt;e 开始-&gt;判断条件1为no-&gt;判断条件2为no-&gt;判断条件3为no-&gt;输出-&gt;结束 </code></pre> <table> <thead> <tr> <th>形参</th> <th>实参</th> <th>含义</th> </tr> </thead> <tbody> <tr> <td>-&gt;</td> <td>-&gt;</td> <td>链接</td> </tr> <tr> <td>condition</td> <td>c1</td> <td>条件</td> </tr> <tr> <td>(布尔值,方向)</td> <td>(yes,right)</td> <td>若是知足向右链接,4种方向:right ,left,up ,down 默认为:down</td> </tr> </tbody> </table> <p>注:operation (程序); subroutine (子程序) ;condition (条件),均可以在括号里加入链接方向。</p> <pre><code>operation(right) subroutine(left) condition(yes,right) // 只有条件 才能加布尔值 </code></pre> <hr> <p><strong>代码2</strong></p> <p>注:添加样式和url跳转 须要添加第三方的脚本<br> 实际效果不好,使用起来麻烦,意义不大</p> <pre><code>```flow // 流程 st=&gt;start: 启动|past:&gt;http://www.baidu.com[blank] // 开始 e=&gt;end: 结束 // 结束 op1=&gt;operation: 方案一 // 运算1 sub2=&gt;subroutine: 方案二|approved:&gt;http://www.baidu.com[_parent] // 运算2 sub3=&gt;subroutine: 从新制定方案 // 运算2 cond1=&gt;condition: 行不行?|request // 判断条件1 cond2=&gt;condition: 行不行? // 判断条件2 io=&gt;inputoutput: 结果满意 // 输出 // 开始-&gt;方案1-&gt;判断条件-&gt; st-&gt;op1-&gt;cond1 // 判断条件1为no-&gt;方案2-&gt;判断条件2为no-&gt;从新制定方案-&gt;方案1 cond1(no,right)-&gt;sub2-&gt;cond2(no,right)-&gt;sub3(right)-&gt;op1 cond1(yes)-&gt;io-&gt;e // 判断条件知足-&gt;输出-&gt;结束 cond2(yes)-&gt;io-&gt;e // 判断条件知足-&gt;输出-&gt;结束

    演示

    做者地址:flowchart.js

    通常广泛支持的效果


    26.时序图

    代码1

    ```sequence
    A->>B: 你好
    Note left of A: 我在左边     // 注释方向,只有左右,没有上下
    Note right of B: 我在右边
    B-->A: 很高兴认识你
    ```

    演示

    代码详解

    注:A->>B: 你好 后面能够不写文字,可是必定要在最后加上
    Note left of A 表明注释在A的左边

    符号 含义
    - 实线
    > 实心箭头
    -- 虚线
    >> 空心箭头

    代码2

    ```sequence
        起床->吃饭: 稀饭油条
        吃饭->上班: 不要迟到了
        上班->午饭: 吃撑了
        上班->下班:
        Note right of 下班: 下班了
        下班->回家:
        Note right of 回家: 到家了
        回家-->>起床:
        Note left of 起床: 新的一天
        ```

    演示

    27.生成侧边栏扩展

    注:生成侧边栏通常是插入JS,再就是模板,
    整体来讲,非常麻烦,效果通常,不做详解。

    做者仓库:i5ting_ztree_toc

    精简版:做者博客HaleyPKU

    总结:经常使用标记

    标记 Markdown 语法
    斜体 *italic*
    粗体 **bold**
    图片 ![Image Title](http://xxx.png)
    连接 [Link Text](http://xxx.com)
    内联代码 `code`
    块级代码 ```code block```
    引用 > Here is a quote block
    分隔符 ----*****
    标题 1 # Heading 1
    标题 2 ## Heading 2
    标题 3 ### Heading 3
    标题 4 #### Heading 4

    Markdown编写工具

    Typora:https://typora.io





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

    原文地址:https://www.jianshu.com/p/b03a8d7b1719
    相关文章
    相关标签/搜索