本文【MarkDown语法】罗列的所有语法均在Typecho环境下测试通过,且提供清楚详细的写法,以及示例展示。若运用到其他平台出现意外,请自行Google、百度之,当然也可以在此留言。其他文章中出现的诸如流程图,语法高亮等均为MarkDown的扩展语法(高级语法),需要主题或者插件支持。

[FOOT] ↓

一、标题类型

书写格式:

n个 "#" 标题

示例:

# 这是h1级标题
## 这是h2级标题
  ...
###### 这是h6级标题

注:用n个"#"表示,且放在句子或者段落/行开头,一般为了美观,亦可在其末尾加上n个"#"与前呼应。其中#: h1、##:h2、###:h3…以此类推。n=1~6。

二、字体样式

书写格式:

加粗:**内容**  _内容_
倾斜: *内容*    内容
删除线:~~内容~~
示例:
**加粗1**    __ 加粗2__
*倾斜1*    _倾斜2_
***倾斜且加粗***
~~删除线~~

注:字体颜色、大小等设置:<font color="#00ff00" font-size="15px">eonegh.com</font>

三、超链接

1、行内式

书写格式:

[连接名称](网址链接 , 空格 标题)
示例:
欢迎来到Eonegh's Blog(https://eonegh.com)
欢迎来到Eonegh's Blog(https://eonegh.com "Write&Mark&Gossip")这里有title

注:[]里写链接文字,()里写链接地址, ()中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。链接地址与链接标题前有一个空格。

2、参考式

书写格式:

[链接名][链接代号]、 [链接代号] “:” 链接
示例:
Google[1]
欢迎来到 Eonegh's Blog[2]
[1]:http://www.google.com
[2]: https://eonegh.com "Optional Title Here"

注:链接名,在文本的任意位置添加[链接代号] :链接地址 “链接标题”,链接地址与链接标题前有一个空格。后面可以添加属性设置。

3、自动式

书写格式:

<链接>  链接  <邮箱>
示例:
<https://eonegh.com>
<[email protected]>

注:网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

4、图片式

书写格式:

![连接名称](网址 , 标题)
示例:
![Alt text](https://imgs.aixifan.com/content/2016_11_15/1481803536.jpg "Optional title")
    Alt text

注:图片式的超链接就是在行内式超链接的前面添加一个 "!"。

四、锚点

1、页面内跳转

书写格式:

<a id="锚点名" style="样式设置">内容
[跳转到目的地](#锚点名)
示例:
<a id="divtop" style="text-decoration none; color:red">这就是divtop处
[i style="text-decoration none; color:red; font-size:20px">-点击跳转到divtop处- ](#divtop)
-点击跳转到文章开头-

2、注脚

书写格式:

内容[^数字]   [^数字]:注释内容
示例:
使用 Markdown[^1]1可以效率的书写文档, 直接转换成 HTML[^2]2, 你可以使用 Leanote[^3]3 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^3]:开源笔记平台,支持Markdown和笔记直接发为博文 

五、列表

1、无序列表

书写格式:

* 空格 内容   - 空格 内容  + 空格 内容
示例:

  • * 无序列表项 一
  • - 无序列表项 三
  • + 无序列表项 二

注: 示例中,实心点是Markdown语法效果,其后才是书写示例。

2、有序列表

书写格式:

数字 "." 空格 内容。
示例:

  1. 1. 有序列表项 一
  2. 3. 有序列表项 三
  3. 2. 有序列表项 二

注: 示例中,左侧的数字是Markdown语法效果,其后才是书写示例。有序列表的序号是根据第一行列表的数字顺序来的。

3、列表缩进

书写格式:

* 空格 内容   - 空格 内容  + 空格 内容
示例:

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

注:示例中,左侧的数字或者实心点是Markdown语法效果,其后才是书写示例。列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。

4、包含段落的列表

书写格式:

列表段落 插入段落
示例:

  • * 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳,是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!)

  那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

  • * 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。)

注:示例中,左侧的数字或者实心点是Markdown语法效果,其后才是书写示例。列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致)。

5、包含引用的列表

书写格式:

> 内容
示例:
>悄悄的我走了, 正如我悄悄的来;
>我挥一挥衣袖, 不带走一片云彩。
注:如果要在列表项目内放进引用,那 “>” 就需要缩进。

六、引用

1、普通样式

书写格式:

> 行/段落
示例:
>悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

2、多层嵌套

书写格式:

n个 >
示例:

>>>Markdown 是一种轻量级标记语言,创始人为 John Gruber。

>它允许人们

>>使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档。
注:区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > ,此时,每层嵌套的引用末尾需要加上回车(Enter)或者空白行或者">"。

3、其它要素

书写格式: 无
示例:

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

给出一些例子代码:

   return shell_exec("echo $input | $markdown_script");

注:引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。

七、表格

1、标准样式

书写格式:

第一格表头 | 第二格表头
-|-
内容单元格 第一列第一格 | 内容单元格 第二列第一格
内容单元格 第一列第二格 | 内容单元格 第二列第二格

示例:
简单方式写表格:

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

2、指定对齐方向,换行

书写格式:

第一格表头 | 第二格表头
:-:|:-:
内容单元格 第一列第一格 | 内容单元格 第二列第一格 <br /> 内容单元格 第二列第一格换行
内容单元格 第一列第二格 | 内容单元格 第二列第二格
示例:
|产品|价格|
Leanote 高级账号60元/每年
100元/年
Leanote 超级账号120元/年

注:不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。 列于列之间用管道符 "|" 隔开。原生方式的表格每一行的两边也要有管道符 "|" 。 第二行还可以为不同的列指定对齐方向。默认为左对齐( " -|:- " )," -|:-: " 第二列居中、" -|-: " 第二列右对齐。

3、特殊表格之合并

书写格式:

<table>
    <tr>
        <th rowspan="2">课表</th>
        <th>8:30-10:00</th>
        <th>10:20-11:55</th>
        <th>14:00-15:35</th>
    </tr>
    <tr>
        <td>高等数学</td>
        <td>计算机原理</td>
        <td>信号与系统</td>
    </tr>
    <tr>
        <th rowspan="2">课表</th>
        <th>8:30-10:00</th>
        <th>10:20-11:55</th>
        <th>14:00-15:35</th>
    </tr>
    <tr>
        <td>高等数学</td>
        <td>计算机原理</td>
        <td>信号与系统</td>
    </tr>
 </table>

示例:

课表 8:30-10:00 10:20-11:55 14:00-15:35
高等数学 计算机原理 信号与系统
课表 8:30-10:00 10:20-11:55 14:00-15:35
高等数学 计算机原理 信号与系统

注:严格意义上,这种写法不是MarkDown表格写法。它的思路就是直接在正文中写html标签,用来表示复杂的标签,甚至更多功能。例如<th rowspan="2"style="text-align:right">课表</th>此时便是右对齐。rowspan属性规定单元格可横跨的行数。

八、分割线

书写格式:

***     ---    ___
示例:
***


注:三个以上的星号 "*"、减号 "-"、底线 "_" 来建立一个分隔线,行内不能有其他东西。

九、复选框/任务列表

书写格式:

  - [ ] 内容
  - [x] 其他语法+内容
示例:
  • [ ] 前中后的空格
  • [ ] 这是未选中的复选框
  • [x] 这是选中的复选框

注: [ ]前后有空格。html语法:<input type="checkbox" disabled="disabled"> 这是未选中的复选框<input type="checkbox" checked="checked" disabled="disabled"> 这是选中的复选框<code>。其中,不可勾选:disabled="disabled",可勾选: readonly="readonly"。显示如下:

  • 这是未选中的复选框‘-’ + ‘空格’ + ‘[中间有空格]’
  • 这是选中的复选框‘-’ + ‘空格’ + ‘[中间有空格]’

十、键盘键

书写格式:

<kbd>键盘键</kbd>
示例:
( <kbd>Ctrl+[</kbd> and <kbd>Ctrl+]</kbd> )

Ctrl+[ and Ctrl+]

十一、代码框

1、单行代码

书写格式:

(行内)一对单联反引号 " ` ", (行头)或者4个空格、或者1个(tab)
示例:
行内代码:

Use the printf(\n) function.

代码框:

.CloseDirectoryWindow{
  font-size: 7vmin;
  border:none;
  background:rgba(255, 255, 255, 0);
  float:left;
  margin: -50px 0px 0 6px;
  color: #ff0000!important;
}

2、代码区块

书写格式:

```  代码部分  ```
示例:
<p>This is a blockquote.</p>
<p>This is a blockquote.</p>

十二、行与段落

1、中文首行缩进

书写格式:

4个 "&ensp;"   2个 "&emsp;"   中文全角输入模式(shift + space)下2次空格(Space)
示例:
    Raphael also has a few advantages that D3 does not. Raphael has a much lower learning curve. From an artistic point-of view, you may not wish to spend months getting used to your tools, when all you really want do is to start painting.
    Another huge advantage of Raphael is that it will work in older browsers. Older versions of IE do not allow SVG to be rendered directly. Raphael will even work in IE6, something which very few modern tools can claim. From the very important standpoint of usability and user experience.

2、换行

书写格式:

<br />, 或者直接回车(Enter)

3、空白行

书写格式:

回车(Enter)<br />     回车(Enter)&nbsp;&nbsp;     回车(Enter)&ensp;     回车(Enter)

4、行/段落格式化

书写格式:

<PRE> 行/段落 <PRE>
示例:
                                                Raphael also has a few advantages that D3 does not. 
  Raphael has a much lower                                             learning curve. From an artistic point-of view, you                wish to spend months getting used to your tools, when all you
really want do is to start painting. Another        advantage of Raphael is that it will work in older browsers. 
                    Older versions of IE do not allow SVG to be rendered directly. Raphael will even
 work in
 IE6,
 something which very few modern tools can claim. 
                                            From the very important standpoint of usability and user experience.

注:从<PRE>到</PRE>中的内容原来怎么分的行,就怎么分,转化的HTML不加<br>。

十三、参考文档

注:以上语法适用Typecho程序环境:Typecho v1.1 (17.10.30)

↑ [TOP]


  1. Markdown是一种纯文本标记语言
  2. HyperText Markup Language 超文本标记语言
  3. 开源笔记平台,支持Markdown和笔记直接发为博文

本文标签:MarkDown