Markdown 语法

2017-04-01 本文已影响0人金樽明月

兼容 HTML

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。
要制约的只有一些 HTML 区块元素―― 比如 <div>、<table>、<pre>、 <p>等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的 <p> 标签。
HTML 的区段（行内）标签如 <span>、<cite>、<del> 可以在 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 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 <img> 标签
```
 ![](a.jpeg "图片")
```

表格

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

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

<table>
    <tr>
        <td>设备</td>
    <td>设备</td>
    <td>设备</td>
    <td>设备</td>
   </tr>
</table>
很明显，简书并不支持这种方式！！！

页内跳转和目录生成

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

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

  <h1 id="screen_bightness">屏幕亮度</h1>
        * <h3 id="get_screen_bightness_this">获取当前屏幕亮度</h3> 
        * <h3 id="get_screen_bightness_this">获取当前屏幕模式</h3>

效果：

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

<h3 id="get_screen_bightness_this">获取当前屏幕亮度</h3>
<h3 id="get_screen_bightness_this">获取当前屏幕模式</h3>

其他

自动连接

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

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

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

反斜杠 \

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

工具

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