最完整的Markdown基础教程

129次阅读

共计 2494 个字符,预计需要花费 7 分钟才能阅读完成。

提到 Markdown,很多人首先想到的是简单、Easy 等等。的确,Markdown 为简单而生。Markdown 是由一个叫 JOHN GRUBER 的哥们发明的,它的语法用一篇文章就可以说完。不相信吗? 让我们来试试看 …

基础语法

标题

Markdown 支持 6 种级别的标题,对应 html 标签 h1 ~ h6

# h1

## h2

### h3

#### h4

##### h5

###### h6

以上标记效果如下:

h1

h2

h3

h4

h5

h6

除此之外,Markdown 还支持另外一种形式的标题展示形式,其类似于 Setext 标记语言的表现形式,使用下划线进行文本大小的控制

这是一级标题

===

这是二级标题

使用这种方式处理标题仅有两种表现形式,即一级标题和二级标题。遗憾的是,简书并不支持这种语法。因此,我们用一张图来展示效果:

这种处理方式在 Github 的一些开源工程上面比较常见,显而易见的缺点是:文字大小控制级别有限。

段落及区块引用

需要记住的是,Markdown 其实就是一种易于编写的普通文本,只不过加入了部分渲染文本的标签而已。其最终依然会转换为 html 标签,因此使用 Markdown 分段非常简单,前后至少保留一个空行即可。

而另外一个比较常见的需求就是,我们可能希望对某段文字进行强调处理。Markdown 提供了一个特殊符号 > 用于段首进行强调,被强调的文字部分将会高亮显示

> 这段文字将被高亮显示 …

以上标记显示效果如下:

这段文字将被高亮显示 …

插入链接或图片

Markdown 针对链接和图片的处理也比较简单,可以使用下面的语法进行标记

以上标记显示效果如下:

注:引用图片和链接的唯一区别就是在最前方添加一个感叹号。

列表

Markdown 支持有序列表和无序列表两种形式:

无序列表使用 * 或 + 或 - 标识

有序列表使用数字加. 标识,例如:1.

* 黄瓜

* 玉米

* 茄子

+ 黄瓜

+ 玉米

+ 茄子

– 黄瓜

– 玉米

– 茄子

1. 黄瓜

2. 玉米

3. 茄子

以上标记显示效果如下:

黄瓜

玉米

茄子

黄瓜

玉米

茄子

黄瓜

玉米

茄子

黄瓜

玉米

茄子

注:这里比较有趣的地方是,对于有序列表,Markdown 将只关注你的第一个项目的数字编号。例如:如果第一个项目编号是 3. 以此类推,第二个项目应该是 4. 最终将显示为 3、4、5. 而如果你指定了第一个编号,后面的编号指定错误也没有关系,Markdown 将只在乎你的第一个项目编号。

使用列表的一些注意事项

如果在单一列表项中包含了多个段落,为了保证渲染正常,* 与段落首字母之间必须保留四个空格

* 段落一

小段一

* 段落二

小段二

以上标记显示效果如下:

段落一

小段一

段落二

小段二

另外,如果在列表中加入了区块引用,区域引用标记符也需要缩进 4 个空格

* 段落一

> 区块标记一

* 段落二

> 区块标记二

段落一

区块标记一

段落二

区块标记二

注:记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。

分隔线

有时候,为了排版漂亮,可能会加入分隔线。Markdown 加入分隔线非常简单,使用下面任意一种形式都可以

***

产生分隔线的语法要求比较松,符号之间添加空格也可以。

强调

有时候,我们希望对某一部分文字进行强调,使用 * 或_包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗

* 这里是斜体 *

_这里是斜体_

** 这里是加粗 **

__这里是加粗__

这里是斜体

这里是斜体

这里是加粗

这里是加粗

高级用法

插入代码块

Markdown 在 IT 圈子里面比较流行的一个重要原因是,它能够轻松漂亮地插入代码。

方法是,使用反引号 ` 进行包裹即可。如果是行内代码引用,使用单个反引号进行包裹

这是一段 var x = 3 行内代码

如果插入一整段代码,需要至少使用两个以上反引号进行包裹,看效果:

fun (x: Int, y: Int): Int {

return x + y

}

注:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧 esc 键下面的第一个键点击即可。

插入表格

表格是 Markdown 语法中比较复杂的一个,其语法如下:

表头 | 条目一 | 条目二

:—:|:—:|:—:

项目 | 项目一 | 项目二

以上标记显示效果如下:

表头 条目一 条目二
项目 项目一 项目二

注:三个短斜杠左右的冒号用于控制对齐方式,只放置左边冒号表示文字居左,只放置右边冒号表示文字居右,如果两边都放置冒号表示文字居中。

其它

特殊符号处理

Markdown 使用反斜杠 \ 插入语法中用到的特殊符号。在 Markdown 中,主要有以下几种特殊符号需要处理:

\ 反斜线

` 反引号

* 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

# 井字号

+ 加号

– 减号

. 英文句点

! 惊叹号

例如,如果你需要插入反斜杠,就连续输入两个反斜杠即可:\\ => \。

注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。

如何给文字上色

使用 Markdown 的同学最郁闷的地方恐怕就是不能给文字添加颜色了。事实上,Markdown 的最初目标就是为纯写作而生的。因此,它并没有考虑文字颜色这一点。所以,单纯使用 Markdown 设置文字颜色已经做不到了。但你可以这样做:

先用 Markdown 编辑完成

导出为 html,在需要上色的部分手动添加标签保存即可。

Markdown 软件推荐

如果你是一个 Mac 用户,我推荐你使用开源的 MacDown:

Macdown

如果你愿意花钱的话,一些收费产品其实更好。例如:Byword,Ulysses,Typora 等等都很不错。

日常使用,我就用 Macdown。写书,我就用 Ulysses。

简单总结

Markdown 是一门比 html 更简单的标记语言,其主要用于日常写作。最终通过相应的编辑器或者脚本转换成 html 用于页面渲染。如果你是一个作家,或者是一个程序员,Markdown 对你来说是一门必备的技能。掌握 Markdown 真的很简单,如你所见,这篇文章使用了这么短的篇幅就已经将 Markdown 的语法全部介绍完了。

不过,由于 Markdown 基础语法的限制,出现了一些针对 Markdown 语法的加强版本。它支持的语法特性更多,但这不是我们这篇文章的讨论范围。如果你希望快速掌握 Markdown,很简单,动起来吧!

正文完
 
天天
版权声明:本站原创文章,由 天天 2023-04-26发表,共计2494字。
转载说明:

本文由 天天资讯网 整理发布,转载请注明出处.
版权声明:部分文章内容或图片来源于网络,我们尊重作者的知识产权。如有侵犯,请联系我们在第一时间删除。