Markdown 简明教程

Author Avatar
SphaelaClarx 2019年06月09日
  • 在其它设备中阅读本文章

Markdown 是一种轻量级标记语言,排版语法简洁明了,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与 HTML 混编,可导出 HTML、PDF 以及本身 .md 格式的文件。Markdown 的语法全部由一些常用符号所组成,这些符号经过精挑细选,其作用一目了然。

在开始之前,需要特别注意的点

  • 通常,格式控制符号与文本内容需要保留一个空格
  • 段落之间需要空格一行。如果需要在段落内加入换行,可以在前一行的末尾加入至少两个空格,然后换行写其它的文字。

标题

在书写中,标题是最常用的格式,Markdown 中,通过在文本前加上 # 即可。同时,根据 # 的数量可以划分为一级标题、二级标题、三级标题、...一共六级,分别对应 HTML 中的 <h1>一级标题</h1><h6>六级标题</h6>

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表

列表分为无序列表和有序列表,无序列表在每行开头加上 -+* 均可,也可以三者混合一起,推荐使用相同的字符,避免混乱。

- 无序列表一
+ 无序列表二
* 无序列表三
  • 有序列表一
  • 有序列表二
  • 有序列表三

而有序列表仅需要在文本前面加上 数字 +. 即可,数字的序列并不会影响生成的列表序列,但仍然推荐按照自然顺序(1.2.3...)编写

1. 有序列表一
3. 有序列表二
4. 有序列表三
  1. 有序列表一
  2. 有序列表二
  3. 有序列表三

无序列表和有序列表可以随意相互嵌套

1. 有序列表一
  - 无序列表 1-1
  - 无序列表 1-2
    - 无序列表 1-2-1
    - 无序列表 1-2-2
2. 有序列表二
  - 无序列表 2-1
  - 无序列表 2-2
  1. 有序列表一

    • 无序列表 1-1
    • 无序列表 1-2

      • 无序列表 1-2-1
      • 无序列表 1-2-2
  2. 有序列表二

    • 无序列表 2-1
    • 无序列表 2-2

引用

在段落或其他内容前使用 > 符号,就可以将这段内容标记为引用内容

>引用内容
引用内容
>如果仅在第一行使用 `>`,
后面相邻的行即使省略 `>`,也会变成引用内容
如果仅在第一行使用 >
后面相邻的行即使省略 >,也会变成引用内容
>如果引用内容需要换行,  
>可以在行尾添加两个空格
>
>或者在引用内容中加一个空行
>
>也可以在引用中
>>使用嵌套的引用

如果引用内容需要换行,
可以在行尾添加两个空格

或者在引用内容中加一个空行

也可以在引用中

使用嵌套的引用

代码块

行内代码块

在文本前后加入 ` 即可

I am a `code`

I am a `` ` ``

I am a code

I am a `

段落代码块

在段落前后分别加上 ``` 即可,后边可以加上语言名称来标记使用的语言

System.out.println("MarkDown");

文字修饰

为了表达的抑扬顿挫,需要使用到粗体、斜体、删减体等来表明重点。其中用 * 包围起来的文字为斜体,用 ** 包围起来的文字为粗体,用 *** 包围起来的文字为斜粗体,而使用 ~~ 包围起来的文字则为删减体

*斜体* **粗体** ***粗斜体*** ~~删减体~~

斜体 粗体 粗斜体 删减体

分割线

可以在一行中使用三个或更多的 *- _ 来添加分隔线

***
------
___


链接及图片

链接和图片可以为文章润色不少,通过 [描述](地址) 即可以添加链接,而在其前面添加一个 ! 号即为添加图片

[Apple(中国大陆)官网](https://www.apple.com/cn)

![Google Logo](https://i.pixbeta.com/assest/googlelogo.jpg)

Apple(中国大陆)官网

Google Logo

使用 <> 包括的 URL 或邮箱地址会被自动转换为超链接

<https://www.apple.com/cn>
<hi@pixbeta.com>

https://www.apple.com/cn
hi@pixbeta.com

字符转义

反斜线 \ 用于插入在 Markdown 语法中有特殊作用的字符

这是用来 *演示* 的 _文本_

这是用来 \*演示\* 的 \_文本\_

这是用来 演示文本

这是用来 *演示* 的 _文本_

表格

| First Header | Second Header | Third Header |
| ------------ | ------------- | ------------ |
| Content Cell | Content Cell | Content Cell |
| Content Cell | Content Cell | Content Cell |
First HeaderSecond HeaderThird Header
Content CellContent CellContent Cell
Content CellContent CellContent Cell

通过在标题分割行添加冒号:,表格单元的对其格式可自定义:向左靠齐,居中和向右靠齐;表格中可以插入其他 Markdown 中的行内标记

| Netflix 订阅价格 | Standard |  Premium |
| :----- | :-----:| -----: |
| 美国 | USD12.99 | USD15.99 |
| 香港 |  HK$78 | HK$93 |
| 土耳其 | TRY29.99 | TRY41.99 |
| 日本 | JPY1200 | JPY1800 |
| 中国大陆 | **N/A** | **N/A** |
Netflix 订阅价格StandardPremium
美国USD12.99USD15.99
香港HK$78HK$93
土耳其TRY29.99TRY41.99
日本JPY1200JPY1800
中国大陆N/AN/A

以上语法基本可以满足日常的使用需求,借助解析器与编辑器的扩展支持,还可以实现使用 Markdown 插入 数学公式Emoji脚注 等功能。

下面是一些推荐的 Markdown 编辑器:

兼容 HTML

Markdown 可以和 HTML 混编,甚至可以完全用 HTML 语法来写。在 HTML 标签中的 Markdown 代码是不起作用的。

<ruby>
注<rp>(</rp><rt>zhù</rt><rp>)</rp>
音<rp>(</rp><rt>yīn</rt><rp>)</rp>
</ruby>

<div>
# HTML 标签里面的 Markdown 语法不起作用
**你看我没有变粗**
</div>


(zhù)
(yīn)

# HTML 标签里面的 Markdown 语法不起作用 **你看我没有变粗**

在 HTML 中所有 <& 都要转换,包括链接(URL)

  • &lt; 表示 <——起始标签
  • &amp; 表示 & ——标记 HTML 实体

常用弥补 Markdown 的 HTML 标签

字体

<font face="微软雅黑" color="blue" size="5">字体及字体颜色和大小</font>
<font color="#f08eaf">字体颜色</font>

字体及字体颜色和大小
字体颜色

文本对齐方式

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

居左文本

居中文本

居右文本

REF

本文链接:https://pixbeta.com/markdown-tutorial.html
本文采用 CC BY-NC-SA 4.0 CN 协议进行许可