任务列表

To-do任务列表是一种很常见的时间管理工具,它适用于工作计划、个人生活以及家庭学习。Markdown的To-Do List的内容是由无序列表,复选框,图标几种功能的组合。

在Markdown文件中,在 无序列表 -,+,* 后面使用 中括号 [ ]声明复选框。在中括号中写入 x,便可实现选中效果。

1
2
- [ ] Java
- [x] Php
  • Java
  • Php

特殊符号

Markdown允许使用反斜杠,将有特殊含义的字符体现在文本之中。例如,当希望在一个单词周围增加星号*时,(默认会被转化成 HTML 的 <em> 标签),可以通过在符号前面插入反斜杠将其转义。

1
2
3
4
如果不使用转义字符,以下算式将不能按预期输出  
2*3*4=24
以上算式的正确写法为:
2\*3\*4=24

如果不使用转义字符,以下算式将不能按预期输出
234=24
以上算式的正确写法为:
2*3*4=24

Markdown 中提供了对以下特殊字符的转义支持。

特殊符号 中文名称 默认语法
\ 反斜杠 转义符号,需要与其他特殊符号连用
` 反引号 用于定义行内代码、代码块
* 星号 用于定义无序列表、强调、分割线
_ 下划线 用于定义强调、分割线
{ 大括号 用于定义公式
[ 中括号 用于定义超链接、图片
( 小括号 用于定义超链接、图片
# 井号 用于定义标题、粗体字
+ 加号 用于定义无序列表、分割线
- 减号 用于定义无序列表、分割线
. 点号 用于定义有序列表
! 叹号 用于定义超链接、图片

注释

Markdown的注释可以通过三种方法实现:第一是通过html的 <!-- --> 标记;第二可以通过样式隐藏段落内容,即 <div style="display:none">;第三是通过Markdown自身的解析原理实现。

使用原生 HTML 注释语法

此种方法被注释的内容是不被渲染输出的。

1
2
3
<!-- 这是一段被注释掉的文字 -->

这是一段没有被注释的文字

这是一段没有被注释的文字


使用 HTML 样式实现隐藏

这种方式原则上并不是注释,而是将内容隐藏,已达到注释效果。

1
2
3
4
5
<div style="display:none">
这是一段被注释掉的文字
</div>

这是一段没有被注释的文字
这是一段被注释掉的文字

这是一段没有被注释的文字


通过Markdown自身解析

这种方法是利用了Markdown自身的语法,在超链接的内容中通过中括号 []的方式定义全局超链接,而这种方式声明的内容不会被渲染成文字内容输出,因此达到了注释的效果。

1
2
3
[//]: (这是一段被注释掉的文字)

这是一段没有被注释的文字

这是一段没有被注释的文字


表格

表格通常作为一种布局形式,用于结构化的数据展示。Markdown表格包含三个部分:表头、分割线、数据。

在分割线上使用 :可以定义列内容的对齐方式。

1
2
3
4
5
|左对齐|居中对齐|右对齐|
|:--|:--:|--:|
|1|张三|17岁|
|2|李四|18岁|
|3|王五|19岁|
左对齐 居中对齐 右对齐
1 张三 17岁
2 李四 18岁
3 王五 19岁

脚注尾注

脚注和尾注都是对文章的补充说明。

脚注通常与被注释内容出现在同一页,并位于该页面的最下方,一般用来解释专有名词、数据来源等。

1
2
3
4
5
6
7
8
**《出师表》(节选)**

先帝[^注释1]创业[^注释2]未半而中道[^注释3]崩殂[^注释4],

[^注释1]: 先帝:指汉昭烈帝刘备。先,尊称死去的人。
[^注释2]: 创:开创,创立;业:统一天下的大业。
[^注释3]: 中道:中途。
[^注释4]: 崩殂(cú):死。崩,古时指皇帝死亡。殂,死亡。

《出师表》(节选)

先帝^注释1创业^注释2未半而中道^注释3崩殂^注释4