说明
本教程基于 Markdown 语言编写,项目地址位于 Simple-Markdown-Guide。
本教程定位为基础教程,更加详细的用法可参考其他资料。
基本
Markdown 是一种用来写作的轻量级标记语言。
用 标记语法,来代替常见的排版格式。
特殊字符自动转换,例如 < 和 & 。
兼容 HTML 代码。
为什么要使用它?
它 易读(看起来舒服)、易写(语法简单)、易更改(纯文本)。处处体现着极简主义的影子。
兼容 HTML ,可以转换为 HTML 格式发布。
跨平台使用。
越来越多的网站支持 Markdown 。
因为 在这个社区发帖要用。(别打我
字体
使用星号 * 和底号 _ 表示 标签。
例如:
斜体
斜体
效果:
斜体
使用双星号 ** 和双底号 __ 表示 标签。
例如:
强调
强调
效果:
强调
换行
单一段落用空白行。
或是选择在行末加两个空格。
标题
生成
- 标签,是通过在文字前面加上同等个数 # 符号来实现。
出于美观,也可以使用 对称的 闭合式标题符号。
例如:这是标题
这是标题
出于美观,也可以使用 对称的 闭合式标题符号。
例如:
这是标题
这是标题
效果:
这是标题
列表
*,-,+ 这三个符号效果都一样,这3个符号被称为 Markdown 列表符号。而有序列表则使用数字接着一个英文句点(数字大小并不会影响输出序列)。
例如:
- 第一行
- 第二行
- 第三行
- 第四行
- 第五行
- 第六行
效果:
无序列表:
第一行
第二行
第三行
有序列表:
- 第四行
- 第五行
- 第六行
引用
符号表示引用,可简写于第一行,也可以每一行都添加。
区块的引用可以嵌套,只需要在层次数上加上同等数量的 > 符号。
引用内可以使用其他 Markdown 语法,包括 标题、列表、代码区块 等。
例如:
引用引用中的引用
效果:
引用
引用中的引用
链接
Markdown 支持两种形式的链接语法:行内式 和 参考式 两种形式。
行内式链接,是在方括号后面接圆括号即可。
例如:
ynym
效果:
ynym
图片
Markdown 使用一种和链接很相似的语法来标记图片,只是多了一个 ! 在最前面。
目前为止,Markdown 还没有办法指定图片的宽高。
行内式链接,是在方括号后面接圆括号即可。
例如:
效果:
Tamako's Sticker 092
代码区块
是表示 inline 代码,4个 (空格)来表示缩进式代码段,分别对应HTML的 <code>,<pre> 标签。也可以使用
`` 来表达围栏式代码块,并指定他的语言类型,实现语法高亮。围栏式代码块可以大量减少缩进的使用,大规模的代码块使用非常方便。
例如:
sort()
函数按升序对给定数组的值排序。
围栏式代码块
<?php
$my_array = array('a' => 'Dog', 'b' => 'Cat');
sort($my_array);
print_r($my_array);
?>
效果:
sort() 函数按升序对给定数组的值排序。
围栏式代码块
<?php
$my_array = array('a' => 'Dog', 'b' => 'Cat');
sort($my_array);
print_r($my_array);
?>
特殊符号
Markdown 利用 \ 字符来转义一些在语法中有特殊意义的符号。
评论