Markdown语法大全
kite1874 / 2019-04-25 / Kite's Life / 阅读量 1233

Markdown 的用法

Markdown是为码字重度用户设计的,如果你对Markdown语法足够熟悉,写一篇文章以及给文章排版,你甚至连鼠标都不需要用到。如果你是自媒体,或者网站小编、码农等等学学Markdown还是不错的。

标题

Markdown 支持两种形式的标题, Setext 和 atx.
Setext 等号表示一级标题,连字符「-」表示二级标题

这是一级标题
=============
这是二级标题
-------------

推荐用[atx] [2]

# 这是一级标题
## 这个二级标题
## 这是三级标题

依次类推h1~h6。

块引用

块引用的三种用法「在使用>时,后面需要加空格。」

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

>  Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

块引用嵌套块引用

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

块引用嵌套标题, 列表和代码块

> ## This is a header.
>
> 1.   This is the first list item.
> 2.   This is the second list item.
>
> Here's some example code:
>
>     return x;

列表

无序列表「『*』可以使用『+』『-』代替」

*    R
*    G
*    B

有序列表「前面的序号可以是任意数字,也不需要按照顺序。」

1.    R
2.    G
3.    B

如果列表项包含多个段落, 列表项中的每个段落都必须用 4 个空格或一个水平制表符来缩进。

*    R
    R is red!
*    G
*    B

如果列表项中包含块注释 , 块注释标记 > 需要缩进:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

代码块

在代码前缩进 4 个空格或者 1 个水平制表符

some code
    <div>a</div>

在代码前面空出一行,并在代码前缩进 4 个空格或者 1 个水平制表符

some code

    <div>a</div>

这两种代码块的显示的样式不同。「可能是Markdown编辑器的问题」

水平线

* * *

***

*****

- - -

---------------------------------------

链接

Markdown支持两种链接形式: 内联 和 引用.「链接绝对路径和相对路径都能使用」
内联

    kite1874's [blog](https://kite1874.com "填写title属性值")

引用

    kite1874's [blog][href]
    [href]:https://kite1874.com "填写title属性值"

链接定义可以放在 Markdown 文档的任意位置. 一般倾向于将它们直接放在引用位置下面, 当然, 也可以像底部注释那样, 将它们都放在文档底部.这种写法只是便于阅读。

图片

图片的引用和链接用法基本一样。主要区别在于图片需要在[]前加!
内联

    [atl属性的值](https://kite1874.com/xxx.png "填写title属性值")

引用

    [atl属性的值][url]
    [url]:https://kite1874.com/xxx.png "填写title属性值"

强调

「*」对应的是;[**]对应的是

*single asterisks*

**double asterisks**

代码

    javascript `function()`.

生成

    <p>javascript <code>function()</code> .</p>

如果代码内容需要用到「`」。为了避免Markdown语法出错

    javascript ``function(`)``.
    javascript `` ` ``
    javascript `` `kite1874` ``

生成

    <p>javascript <code>function(`)</code>.</p>
    <p>javascript <code>`</code></p>
    <p>javascript <code>`kite1874`</code></p>

指定代码类型,例如HTML。

<div></div>

自动链接

创建 URL的简短形式

<https://kite1874.com/>

生成

<a href="https://kite1874.com/">https://kite1874.com/</a>

创建 email 地址链接的简短形式

<address@example.com>

放斜杠转移「坑!」

例如,你想在网页上显示「*literal asterisks*」,这时候你就需要在*前加上。

\*literal asterisks\*

生成

*literal asterisks*

Markdown 为下面字符提供反斜杠转义:

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

最后就是说一下在Markdown中使用HTML需要注意的点。
在使用块级元素时,必须另起一行。内联元素则不要另起一行。

USE HTML
<div>HTML标签</div> 

还要就是HTML需要添加CSS样式时直接使用HTML标签来实现。

个人博客:https://kite1874.com
微信公众号:kiteLife