Markdown 语法

兼容 HTML

1. 不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰 写。不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。
   要制约的只有一些 HTML 区块元素―― 比如

   、、

   、 
   等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩 进。Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的 
    标签。
    
     
   HTML 的区段（行内）标签如 、、 可以在 Markdown 的段落、列表或是标题里随 意使用
    
     
   特殊字符的自动转换
    ©:©
    &
    
     
    
   标题
    
    
   方式一
    
    
       最高阶标题====
       
       二阶标题-------
    
    
   方式二
    
    
       1-6个#
    
    
   区块引用
    
    
   区块引用可以嵌套，也可以在区块引用中使用其他语法
    
    
   这是原始代码：
    > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
    > > This is nested blockquote.
    > ## 这是一个标题。
    >
    > 1. 这是第一行列表项。
    > 2. 这是第二行列表项。
    >
    > 给出一些例子代码：
    >
    > return shell_exec("echo $input | $markdown_script");
    
    
    
     
   This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
    
     
    
      
   This is nested blockquote.
    
     
    
     
   这是一个标题。
    
     
    
      
   这是第一行列表项。
    
      
   这是第二行列表项。
    
     
    
     
   给出一些例子代码：
    
     
   return shell_exec("echo $input | $markdown_script");
    
    
    
    
   列表
    
    
   无序列表
    
    
   可以使用 *, _, +三种符号
    
    
     * 第一条
     * 第二条
    
    
    
     
   第一条
    
     
   第二条
    
    
    
    
   有序列表
    
    
    
     
   列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符：
    
     
   如果要在列表项目内放进引用，那 > 就需要缩进（的语法是不能缩进）
    >afa
    
    
    
    
    
     
   afa
    
    
    
    
    
     
   特殊情况：1986. What a great season. 之所以是特殊情况是因为 数字+点+空格 的格式和有序列表的格则相同，Markdown 语法会解析成列表项
    事实上，可以这样写：
    1986. What a great season.
    
    
    
    
   代码区块
    
    
   缩进 4 个空格或是 1 个制表符（是 4 个空格）
    
    
   分割线
    
    
   一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。
   你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线
    
    
   区段元素
    
    
   链接
    
    
    
     
   行内式
    This is an example inline link.
    This is an example inline link.
    This is [an example](http:// example.com/ "Title") inline link.
    This is an example inline link.
    
     
    
   参考式
    2.1 标签不区分大小写
    2.2 注意 id 的书写位置
    
   This is [an example][id] reference-style link.
   This is [google][] reference-style link
    
   This is an example reference-style link.
    This is google reference- style link.
    
    
    
    
    
   强调
    
    
   可以用这两种符号 * _
    
    
   *HH*
   **HH**
    
    
   HH
    HH
    
    
   代码
    
    
    
     
    
   反引号把它包起来（`）
    
    Use the`printf()`function.  
    
   Use theprintf()function.
    
    
     
    
   如果要在代码区段内插入反引号，你可 以用多个反引号来开启和结束代码区段
    
     ``There is a literal backtick (`) here.``
    
   There is a literal backtick (`) here.
    
    
     
    
   代码区段的起始和结束端都可以放入一 个空白，这样你就可以在区段的一开始 就插入反引号
    
   A backtick-delimited string in a code span: `foo`
    A backtick-delimited string in a code span: `foo`
    
    
    
    
    
   图片
    
    
    
     
   行内式和参考式（同链接）
    
     
    
   到目前为止，Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的  标签
    
    ![](a.jpeg "图片")
    
    
    
    
    
     
     
    
    
    
    
   表格
    
    
   | 水果        | 价格    |  数量  |
   | --------   | -----:  | :----: |
   | 香蕉        | $1      |   5    |
   | 苹果        | $1      |   6    |
   | 草莓        | $1      |   7    |
    
    

   水果	价格	数量
   香蕉	$1	5
   苹果	$1	6
   草莓	$1	7

   
       
   
           
   设备
       
   设备
       
   设备
       
   设备
      
   
   很明显，并不支持这种方式！！！
   

   页内跳转和目录生成

      的 md 支持可能与其他平台有差异，在 MacDown 和 github 上都是完美支持的。有时间，我会再解决这个问题的。
   

   源代码
   * 1.屏幕亮度
   * 1.1 获取当前屏幕亮度
   * 1.2 获取当前屏幕模式

     
   屏幕亮度
           * 
   获取当前屏幕亮度
    
           * 
   获取当前屏幕模式
   

   效果：

   • 1.屏幕亮度
     • 1.1 获取当前屏幕亮度
     • 1.2 获取当前屏幕模式

   屏幕亮度

   • 获取当前屏幕亮度

   • 获取当前屏幕模式

   其他

   自动连接

   Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。

   http://example.com/
   [email protected]

   反斜杠 \

   大家都明白：转义作用。就是把 Markdown 语法和 HTML 语法中的特殊字符转义成普通字符

   工具

   1. 在线工具无限多，就不提了
   2. PC端应用
      • Mac下推荐 MacDown，这是基于 Mou 改进的一款个人免费开源产品， Mou 已被商业化了...
      • Windowns下推荐 MarkdownPad。软件还是不错的，只是Windows系统.....

   参考链接