Markdown:入门教程

本文将会从 Markdown 最重要的几点知识元素进行入门学习。

(PS:本文中,配图部分,均选用了 VSCode 作为 Markdown 编辑器进行效果演示)


Markdown 入门必知:

  • 标题
  • 列表
  • 链接和图片
  • 引用
  • 粗体和斜体
  • 代码
  • 表格

首先,看下 Markdown 的优点:

  • 纯文本
  • 可以让你专注于文字而不是排版
  • 格式转换方便(Markdown 的文本,你可以轻松转换为 html、pdf、word、ppt 等格式)
  • Markdown 的标记语法有极好的可读性

下面,直接入正题 ……

标题

这是最为常用的格式。在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题(文本)格式

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

注: #「一级标题」 之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

(PS:这个其实和网页中的标题是一致的,分别对应 html 中的 <h1></h1> …… <h6></h6> 的标签。)

列表

列表可以分为无序列表和有序列表,它们分别对应于 html 中的 <ul></ul> 和<ol></ol> 。这个也是非常常用的。

Markdown 中的无序列表,你只需要在文字前面加上 - 就可以了。

Markdown 中的有序列表,只需要在文字前面加上 1. 就可以了(注意了:事实上,这个可以是任意一个阿拉伯数字再加上一个英文的句号,都可以。而不一定是 1.,也可以是2.,甚至是 111.,对于这个阿拉伯数字到底是几没有要求。Markdown 中会自动按着最正确的数字顺序进行“有序排列”。)。 例如:

注:-1.和文本内容之间要保留一个字符的空格

链接和图片

在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址) 这样的语法即可。

在 Markdown 中,插入图片也不需要其他按钮,你只需要使用 ![](图片链接地址) 这样的语法即可。

两者的语法非常相似。但唯一的区别是,插入图片只是比插入链接多了前面的一个 ! ,并且插入图片不需要 [显示文本] 部分,内部是置空的,即 []。例如:

注:插入图片的语法和链接的语法很像,只是前面多了一个 (并且 [显示文本] 置空)。

Markdown 中,链接是可以点击的,并且点击后会跳转到默认浏览器去打开链接所指定的网址。

但是,图片却是只能显示,并不能点击的。

引用

总会有一些时候,我们写的文字需要 引用 一些其他著作上的文字,那么就可以将 引用 派上用场了。

引用 的使用方法也很简单:你只需要在你想要 引用 的文字前面加上符号 > 。例如:

注:> 和文本之间要保留一个字符的空格

粗体和斜体

在 Markdown 中,粗体和斜体,使用上也很简单。

左右各两个 * 中间包裹的文字,就是粗体的; 左右各一个 *,中间包裹的文字,就是斜体的。 如图:

代码

对于开发者而言,最关心的莫过于如何插入代码了.

对于插入块级代码(单行或多行), 需要连用 3 个 ` 单独占据一行开头,表示开始插入代码块;并且连用 3 个 ` 并且单独占据一行,表示插入代码块结束. 如图:

注: 开头的 3 个 ` 后面声明一下插入的代码块的语言, Markdown 在显示的时候就可以自动按照正确的方式(语法格式)进行代码块的配色了. 推荐必须带上.

对于插入行内代码,只需要两端各使用 1 个 ` ,中间包裹的内容,即为代码元素. 如图:

PS: (补充内容)` 这个“反撇号”的字符,该如何输入呢?

  1. 必须先确保输入法在英文状态下;
  2. 按键盘上 ~ 波浪号键 即可完成输入.

(~ 它的位置在:Tab 键正上面, 同时它也是在 ESC 键的正下面). (如下图)

表格

Markdown 中使用 | 进行表格的快速插入。如图:

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章