美文网首页
第一篇博文： Markdown语法手册

第一篇博文： Markdown语法手册

作者: xuhaowxy | 来源:发表于2017-09-27 00:00 被阅读0次

    Markdown语法手册

    1. 格式控制

    1.1 粗体/斜体

    代码

    *斜体*或_斜体_
**粗体**  
***加粗斜体***

    显示效果
    斜体或斜体
    粗体
    加粗斜体

    1.2 字体大小

    代码

    <font size=4>我是4号字</font>
<small>字体变小</small>
<big>字体变大</big>
<font face="黑体">我是黑体字</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>

    显示效果
    <font size=4>我是4号字</font>
    <small>字体变小</small>
    <big>字体变大</big>
    <font face="黑体">我是黑体字</font>
    <font color=#0099ff size=12 face="黑体">黑体</font>
    <font color=#00ffff size=3>null</font>
    <font color=gray size=5>gray</font>

    2. 标题（#后请加空格）

    代码

    # 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题（最多六级）

    显示效果

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题（最多六级）

    3. 列表

    3.1 有序列表

    语法说明
    有序列表需要在文字前加1.2.3.

    代码

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

    显示效果

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

    3.2 无序列表

    语法说明
    无序列表需要在文字前加-或*

    代码1

    * 无序列表项1
* 无序列表项2
* 无序列表项3

    显示效果1

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

    代码2

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

    显示效果2

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

    3.3 列表缩进

    语法说明
    在每项前加*+tab

    代码

    *   轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！
那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。
寻梦？撑一支长篙， 向青草更青处漫溯； 满载一船星辉， 在星辉斑斓里放歌。但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！
*   悄悄的我走了，正如我悄悄的来；我挥一挥衣袖，不带走一片云彩。

    显示效果

    • 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！
      那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。
      寻梦？撑一支长篙， 向青草更青处漫溯； 满载一船星辉， 在星辉斑斓里放歌。但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！
    • 悄悄的我走了，正如我悄悄的来；我挥一挥衣袖，不带走一片云彩。

    3.4 特殊情况

    错误代码

    I love 
1986. What a great year!

    错误结果
    I love

    1. What a great year!

    正确代码

    I love 
1986\. What a great year!

    正确结果
    I love
    1986. What a great year!

    4. 引用

    语法说明
    需要在文本前添加>即可
    注意：对于多端文字，可以只在段首添加>

    代码

    > 这是一个有两段文字的引用,
 无意义的占行文字1.
 无意义的占行文字2.
 
>无意义的占行文字3.
 无意义的占行文字4.

    显示效果

    这是一个有两段文字的引用,
    无意义的占行文字1.
    无意义的占行文字2.

    无意义的占行文字3.
    无意义的占行文字4.

    4.1 引用的多层嵌套

    代码

    >>> 请问 Markdown 怎么用？ - 小白

>> 自己看教程！ - 愤青

> 教程在哪？ - 小白

    显示效果

    请问 Markdown 怎么用？ - 小白

    自己看教程！ - 愤青

    教程在哪？ - 小白

    4.2 引用其他要素

    引用区块中也可以使用其他Markdown语法。
    代码

    >1.   这是第一行列表项。
2.   这是第二行列表项。
    
>给出一些例子代码：
`return shell_exec("echo $input | $markdown_script");`

    显示效果

    1. 这是第一行列表项。
    1. 这是第二行列表项。

    给出一些例子代码：
    return shell_exec("echo $input | $markdown_script");

    5. 超链接 {#section 5}

    Markdown超链接有两种形式：行内式和参考式。其中，行内式使用较多。

    5.1 行内式

    语法说明
    []中写链接字，()中写链接地址，()中的""部分记录链接的title属性（鼠标放置时显示的字段）。
    形式为[链接文字](链接地址 "链接标题")，其中，链接地址与链接标题之间要有一个空格。

    代码

    欢迎来到[pdd直播间](https://www.panda.tv/6666)

欢迎来到[pdd直播间](https://www.panda.tv/6666 "pdd直播间地址")

    显示效果

    欢迎来到pdd直播间

    欢迎来到pdd直播间

    5.2 参考式

    参考式通常使用于学术论文或者某条超链接被多次使用的场合。

    语法说明
    参考式超链接分为两部分：
    文中：[链接文字][链接标记]
    任何位置（通常是文末）： [链接标记]:链接地址 "链接标题"

    如果使用链接文字作为链接标记，书写方式如下：
    文中： [链接文字][]
    任何位置： [链接文字]:链接地址

    代码

    娱乐时会选择去[pdd直播间][1]看直播放松；学习时会选择去[我的博客][2]静心钻研； 遇到问题会查询[百度][]； 本文的参考博客来自[梵居闹市的博客]。
[1]: https://www.panda.tv/6666 "pdd直播间地址"
[2]: http://www.jianshu.com/users/11fbce2586e2/timeline "xuhaowxy的博客"
[3]: http://http://http://blog.leanote.com/post/freewalk/Markdown "梵居闹市"
[百度]: www.baidu.com "百度"

    显示效果
    娱乐时会选择去[pdd直播间][1]看直播放松；学习时会选择去[我的博客][2]静心钻研； 遇到问题会查询[百度][]； 本文的参考博客来自[梵居闹市的博客]。
    [1]: https://www.panda.tv/6666 "pdd直播间地址"
    [2]: http://www.jianshu.com/users/11fbce2586e2/timeline "xuhaowxy的博客"
    [3]: http://http://http://blog.leanote.com/post/freewalk/Markdown "梵居闹市"
    [百度]: www.baidu.com "百度"

    5.3 自动链接

    Markdown支持直接把网址或电子邮箱地址转化为超链接。

    语法说明
    用<链接地址>，其中如果是网址，必须以http://开头
    代码

    我的邮箱地址<xuhaowxy@qq.com>，
我的博客是 <http://www.jianshu.com/users/11fbce2586e2/timeline>

    显示效果
    我的邮箱地址xuhaowxy@qq.com，
    我的博客是 http://www.jianshu.com/users/11fbce2586e2/timeline

    5.4 锚点

    锚点即超链接的目标位置是本文的其他地方（比如目录），一般用于文内跳转。

    语法说明
    在跳转目标点添加{#标记}
    在其他位置写上[链接文字](#标志)

    代码
    跳转到[第五章](#section 5)

    显示效果
    跳转到[第五章](#section 5)

    6. 插入图片

    插入图片的写法与超链接类似，也分为行内式和参考式两种。

    6.1 行内式

    语法说明
    ![](图片地址 "图片标题")
    代码

    错误图片：
![](图片地址 "图片标题")
美丽花儿：
![美丽花儿](http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿")

    显示效果
    错误图片：


    美丽花儿：
    美丽花儿美丽花儿

    6.2 参考式

    语法说明

    在文档要插入图片的地方写![图片Alt][标记]
    在文档的最后写上[标记]:图片地址 "Title"

    代码

    美丽花儿：
![美丽花儿][flower]
[flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg  "美丽花儿"

    显示效果
    美丽花儿：
    ![美丽花儿][flower]
    [flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿"

    7. 注脚

    语法说明
    在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。

    注意：经测试注脚与注脚之间必须空一行，不然会失效。成功后会发现，即使你没有把注脚写在文末，经Markdown转换后，也会自动归类到文章的最后。

    代码

    使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。

[^1]:Markdown是一种纯文本标记语言

[^2]:HyperText Markup Language 超文本标记语言

[^Le]:开源笔记平台，支持Markdown和笔记直接发为博文

    显示效果
    使用 Markdown[1]可以效率的书写文档, 直接转换成 HTML[2], 你可以使用 Leanote[3] 编辑器进行书写。

    8. 公式（写法同LaTeX）

    8.1 行内公式

    语法说明
    $公式$

    代码
    质能方程为 $E=mc^2$

    显示效果
    质能方程为 $E=mc^2$

    8.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}$$

    9. 表格

    语法说明

    1. 不管是哪种方式，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。
    2. 列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
    3. 第二行还可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐。

    代码
    简单方式写表格：

    学号|姓名|分数
-|-|-
小明|男|75
小红|女|79
小陆|男|92

    原生方式写表格：

    |学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|

    为表格第二列指定方向：

    产品|价格
-|-:
Leanote 高级账号|60元/年
Leanote 超级账号|120元/年

    显示效果
    简单方式写表格：

    学号 姓名 分数
    小明 男 75
    小红 女 79
    小陆 男 92

    原生方式写表格：

    学号 姓名 分数
    小明 男 75
    小红 女 79
    小陆 男 92

    为表格第二列指定方向：

    产品 价格
    Leanote 高级账号 60元/年
    Leanote 超级账号 120元/年

    10. 分隔符

    语法说明
    你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

    代码

    * * *
***
*****

---------------------------------------

    显示效果

    11. 代码

    对于程序员来说这个功能是必不可少的，插入程序代码的方式有两种，一种是利用缩进(Tab), 另一种是利用”`”符号（一般在ESC键下方）包裹代码。

    语法说明

    1. 插入行内代码，即插入一个单词或者一句代码的情况，使用code这样的形式插入。
    2. 插入多行代码，可以使用缩进或者“code “,具体看示例。
      注意： 缩进式插入前方必须有空行

    11.1 行内代码

    代码

    C语言里的函数 `scanf()` 怎么使用？

    显示效果
    C语言里的函数 scanf() 怎么使用？

    11.2 多行代码（缩进）

    代码

    
    #include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

    显示效果

    #include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

    11.3 多行代码（六个`包裹）

    代码

    ```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
```

    显示效果

    #include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

    11.4 HTML源码

    在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，剩下的 Markdown 都会帮你处理，例如：

    代码
    第一个例子：

    <div class="footer">
   © 2004 Foo Corporation
</div>

    第二个例子：

    <table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

    显示效果
    第一个例子：
    <div class="footer">
    © 2004 Foo Corporation
    </div>

    第二个例子：
    <table>
    <tr>
    <th rowspan="2">值班人员</th>
    <th>星期一</th>
    <th>星期二</th>
    <th>星期三</th>
    </tr>
    <tr>
    <td>李强</td>
    <td>张明</td>
    <td>王平</td>s
    </tr>
    </table>

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

    2. HyperText Markup Language 超文本标记语言 ↩

    3. 开源笔记平台，支持Markdown和笔记直接发为博文 ↩

    相关文章

      网友评论

          本文标题：第一篇博文： Markdown语法手册

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

          延伸阅读

          深度阅读

          • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

          栏目导航

          热点阅读

          关于我们|服务条款|联系我们|第一篇博文： Markdown语法手册|投稿指南|网站地图|RSS订阅|排版工具|手机版

          提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

          Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

          备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

          本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

          所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！