Markdown 简明语法教程
侧边栏壁纸
  • 累计撰写 4 篇文章
  • 累计收到 0 条评论

Markdown 简明语法教程

YM
YM
2024-08-15 / 0 评论 / 47 阅读 / 正在检测是否收录...

说明

本教程基于 Markdown 语言编写,项目地址位于 Simple-Markdown-Guide。
本教程定位为基础教程,更加详细的用法可参考其他资料。

基本

Markdown 是一种用来写作的轻量级标记语言。
用 标记语法,来代替常见的排版格式。
特殊字符自动转换,例如 < 和 & 。
兼容 HTML 代码。

为什么要使用它?

它 易读(看起来舒服)、易写(语法简单)、易更改(纯文本)。处处体现着极简主义的影子。
兼容 HTML ,可以转换为 HTML 格式发布。
跨平台使用。
越来越多的网站支持 Markdown 。
因为 在这个社区发帖要用。(别打我

字体

使用星号 * 和底号 _ 表示 标签。
例如:

斜体
斜体
效果:
斜体

使用双星号 ** 和双底号 __ 表示 标签。
例如:

强调
强调
效果:
强调

换行

单一段落用空白行。
或是选择在行末加两个空格。

标题

生成

-
标签,是通过在文字前面加上同等个数 # 符号来实现。
出于美观,也可以使用 对称的 闭合式标题符号。
例如:

这是标题

这是标题

效果:
这是标题

列表

*,-,+ 这三个符号效果都一样,这3个符号被称为 Markdown 列表符号。而有序列表则使用数字接着一个英文句点(数字大小并不会影响输出序列)。
例如:

  • 第一行
  • 第二行
  • 第三行
  • 第四行
  • 第五行
  • 第六行

效果:
无序列表:
第一行
第二行
第三行
有序列表:

  1. 第四行
  2. 第五行
  3. 第六行

引用

符号表示引用,可简写于第一行,也可以每一行都添加。
区块的引用可以嵌套,只需要在层次数上加上同等数量的 > 符号。
引用内可以使用其他 Markdown 语法,包括 标题、列表、代码区块 等。
例如:
引用

引用中的引用
效果:
引用

引用中的引用

链接

Markdown 支持两种形式的链接语法:行内式 和 参考式 两种形式。
行内式链接,是在方括号后面接圆括号即可。
例如:
ynym
效果:
ynym

图片

Markdown 使用一种和链接很相似的语法来标记图片,只是多了一个 ! 在最前面。
目前为止,Markdown 还没有办法指定图片的宽高。
行内式链接,是在方括号后面接圆括号即可。
例如:
Tamako's Sticker 092
效果:
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 利用 \ 字符来转义一些在语法中有特殊意义的符号。

0

评论

博主关闭了所有页面的评论