Markdown 语法系统学习

作者: | 更新日期:

Markdown 用了很久了,但是还有一些没有过,比如加个颜色,加个斜体等。

本文首发于公众号:天空的代码世界,微信号:tiankonguse

前言

以前我总结过 markdown 的使用方法,记录这篇文章之前我回头再次看了一遍记录的那两篇记录: markdown 记录(一)~基础markdown 记录(二)~进阶.
里面记录了常用的语法,现在再系统的记录一次。

什么是Markdown

Markdown是一个将文本转化为HTML的工具。
简单来说,Markdown是一个兼顾可读性与易用性的轻量级标记体系。
Markdown并不追求大而全,它只关心HTML里最常用的几个标记,对于一些不常用的标记它允许直接将HTML标记插入文本。


标题

Markdown提供了两种方式(Setext和Atx)来显示标题。

语法:

Setext方式
标题1
=================

标题2
-----------------

Atx方式
# 标题1
## 标题2
###### 标题6

换行

在文字的末尾使用两个或两个以上的空格来表示换行。


引用

行首使用 > 加上一个空格表示引用段落,内部可以嵌套多个引用。

语法:

> 这是一个引用,
> 这里木有换行,   
> 在这里换行了。  
> > 内部嵌套    
> > 内部嵌套     

效果:

这是一个引用, 这里木有换行,
在这里换行了。

内部嵌套
内部嵌套


列表

无序列表使用 *、 + 或 - 后面加上空格来表示。
有序列表使用数字加英文句号加空格表示。

语法:

* Item 1
* Item 2
* Item 3

+ Item 1
+ Item 2
+ Item 3

- Item 1
- Item 2
- Item 3

1. Item 1
2. Item 2
3. Item 3

效果:

  • Item 1
  • Item 2
  • Item 3

  • Item 1
  • Item 2
  • Item 3

  • Item 1
  • Item 2
  • Item 3
  1. Item 1
  2. Item 2
  3. Item 3

代码区域

行内代码使用反斜杠 ` 表示。
代码段落则是在每行文字前加4个空格或者1个缩进符表示, 当然也可以使用四个 ` 表示。

有时候我们希望在行内代码内使用反引号, 但是会发现转义补齐作用.
这个时候我们就需要使用 另外一种办法了.

To include a literal backtick character within a code span, you can use multiple backticks as the opening and closing delimiters.   
``There is a literal backtick (`) here.``  

强调

Markdown使用 * 或 _ 表示强调。

语法:

单星号 = *斜体*
单下划线 = _斜体_
双星号 = **加粗**
双下划线 = __加粗__
删除线 = ~~加粗~~

效果:

单星号 = 斜体
单下划线 = 斜体
双星号 = 加粗
双下划线 = 加粗
删除线 = 加粗


链接

Markdown支持两种风格的链接:InlineReference

语法:

Inline :以中括号标记显示的链接文本,后面紧跟用小括号包围的链接。如果链接有title属性,则在链接中使用空格加”title属性”。
Reference :一般应用于多个不同位置使用相同链接。通常分为两个部分,调用部分为[链接文本][ref];定义部分可以出现在文本中的其他位置,格式为 [ref]: http://some/link/address (可选的标题)。
注:ref中不区分大小写。

这是一个Inline[示例](http://tiankonguse.github.com "可选的title")。  
这是一个Reference[示例][ref]。  
[ref]: http://tiankonguse.github.com

效果:

这是一个Inline示例
这是一个Reference示例

图片

图片的使用方法基本上和链接类似,只是在中括号前加叹号。

注:Markdown不能设置图片大小,如果必须设置则应使用HTML标记 <img>。

表格

有人问markdown表格的语法是什么, 突然发现把表格遗漏了,现在补上.

语法

| 网站名字 | 网站链接 |
|:-:|:-:|
| tiankonguse's 代码世界	| github.tiankonguse.com/ |
| tiankonguse' record | tiankonguse.com/ |

效果

网站名字 网站链接
tiankonguse’s 代码世界 github.tiankonguse.com/
tiankonguse’ record tiankonguse.com/

分隔线

在一行中使用三个或三个以上的*、-或_可以添加分隔线,其中可以有空白,但是不能有其他字符。

转义字符

Markdown中的转义字符为\,可以转义的有:

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

颜色与字体

markdown 不支持颜色和字体,所以如果想添加颜色或字体,只能使用 html 标签来实现这些需求了。

本文首发于公众号:天空的代码世界,微信号:tiankonguse
如果你想留言,可以在微信里面关注公众号进行留言。

关注公众号,接收最新消息

tiankonguse +
穿越