本文专门针对中文环境,详细演示Markdown的各种常用语法。下面这张图是README.md文件的典型效果预览。

大标题
大标题常用于显示项目名称,类似HTML中的标签。写法非常简便:在标题文字下方连续输入等号(=====)即可。注意等号数量至少要比标题文字长一些,实际上只需一行等号就能生效。
中标题
中标题通常用于展示重要章节,类似HTML的。操作与大标题类似:在标题文字下方连续输入短横线(------)即可。等号和短横线都需要在行首对齐。
小标题
小标题对应HTML的,写法为 ### 小标题。注意井号与标题文字之间必须保留一个空格,否则Markdown解析器可能无法正确识别。
注意!以下所有语法示例的提示均已使用小标题标注,请勿遗漏查看
单行文本框
若需要插入单行文本框,只需在行首按两次Tab键缩进,然后输入文字即可。实际显示效果类似于内联代码片段。
这是一个单行的文本框,只要两个Tab再输入文字即可
多行文本框
多行文本框适用于展示代码块或多行说明文字。每行文字前同样输入两个Tab缩进,再写入内容。下面以Java版本的HelloWorld为例进行演示:
public class HelloWorld {
/**
* @param args
*/
public static void main(String[] args) {
System.out.println("HelloWorld!");
}
}
文字被引用符号包围
这是多重嵌套引用的演示效果。在Markdown中,使用
>符号可创建引用块,连续多个>则代表嵌套层级。上述三层嵌套清晰地展示了从外到内的引用结构。
特殊字符处理
有些字符如<、#属于Markdown语法保留字符,若要在正文中直接显示,只需在这些特殊字符前加上反斜杠(转义符)即可。例如输入\<会显示为<。
此外,在Markdown中需要换行时,也可以直接使用HTML的标签,完全兼容。
行首加点
在行首输入星号*并加一个空格,再输入内容,即可生成无序列表项。这是Markdown中最常用的列表语法之一。例如:
- 列表项一
- 列表项二
