Markdown 基本语法

本篇文章引用于:

1
2
<code>本文作者: Ekkles
本文链接: https://www.ekkles.com/2020/05/markdown/</code>

Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号'`'。

标题

1)使用

1
=
1
-
标记一级和二级标题。

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span><br /><span class="line">4</span>
1
<code><span class="line">一级标题</span></code><br /><span class="line">========</span><br /><span class="line">二级标题</span><br /><span class="line">--------</span>

效果:

一级标题

二级标题

2)使用

1
#
,可表示1-6级标题(注意#和标题中间有空格)

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span><br /><span class="line">4</span><br /><span class="line">5</span><br /><span class="line">6</span>
1
<span class="line"># 一级标题</span><br /><span class="line">## 二级标题</span><br /><span class="line">### 三级标题</span><br /><span class="line">#### 四级标题</span><br /><span class="line">##### 五级标题</span><br /><span class="line">###### 六级标题</span>

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。

区块引用

在段落的每行或者只在第一行使用符号

1
&gt;
,还可使用多个嵌套引用,如:

1
<span class="line">1</span><br /><span class="line">2</span>
1
<span class="line">&gt; 区块引用</span><br /><span class="line">&gt;&gt; 嵌套引用</span>

效果:

区块引用

嵌套引用

代码区块

代码区块的建立是在每行加上4个空格或者一个制表符(如同写代码一样)。如 普通段落:

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span><br /><span class="line">4</span>
1
<span class="line">void main() %注意前面有4个空格</span><br /><span class="line">{</span><br /><span class="line">printf("Hello, Markdown.");</span><br /><span class="line">}</span>

代码区块:

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span><br /><span class="line">4</span>
1
<span class="line">void main()</span><br /><span class="line">{</span><br /><span class="line">printf("Hello, Markdown.");</span><br /><span class="line">}</span>

注意:需要和普通段落之间存在空行。

强调

在强调内容两侧分别加上

1
*
或者
1
_
,如

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span>
1
<span class="line">*斜体*,_斜体_</span><br /><span class="line">**粗体**,__粗体__</span><br /><span class="line">***斜粗体***,___斜粗体___</span>

效果: 斜体斜体 粗体粗体 斜粗体斜粗体

列表

使用

1
&middot;
1
+
、或
1
-
标记无序列表,如:

1
<span class="line">1</span>
1
<span class="line">-(+*) 第一项 -(+*) 第二项 - (+*)第三项</span>

注意:标记后面最少有一个_空格_或_制表符_。若不在引用区块中,必须和前方段落之间存在空行。 效果:

  • 第一项
  • 第二项
  • 第三项

有序列表的标记方式是将上述的符号换成数字,并辅以

1
.,
如:

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span>
1
<span class="line">1. 第一项</span><br /><span class="line">2. 第二项</span><br /><span class="line">3. 第三项</span>

效果:

  1. 第一项
  2. 第二项
  3. 第三项

分割线

分割线最常使用就是三个或以上*,还可以使用-和_。

链接

使用 

1
[描述](链接地址)
 为文字增加外链接。 举例:

1
<span class="line">1</span>
1
<span class="line">[Ekkles的博客](https://www.ekkles.com)</span>

效果: Ekkles的博客

图片

添加图片的形式和链接相似,只需在链接的基础上前方加一个!。 例子:

1
<span class="line">1</span>
1
<span class="line">![zybuluo](https://www.zybuluo.com/static//img/my_head.jpg)</span>

效果:zybuluo

zybuluo

反斜杠
1
\

相当于反转义作用。使符号成为普通符号。

删除线

使用 

1
~~
 表示删除线。 这是一段错误的文本。

表格

Markdown的表格比较麻烦,格式如下 要添加表,使用三个或多个连字符(---)创建每列的标题,并使用竖杠(|)分隔每列。您可以选择在表的任一端添加竖杠。

1
<span class="line">1</span><br /><span class="line">2</span><br /><span class="line">3</span><br /><span class="line">4</span>
1
<span class="line">| Syntax      | Description |</span><br /><span class="line">| ----------- | ----------- |</span><br /><span class="line">| Header      | Title       |</span><br /><span class="line">| Paragraph   | Text        |</span>

 

呈现的输出如下所示:

Syntax Description
Header Title
Paragraph Text

同时,还可以根据需求不同,有其他的格式设置,如对齐,可以对标题行的左侧、右侧或两侧同时添加冒号(:),分别对应于左对齐、右对齐、居中对齐。

由于Markdown的表格相对繁琐,这里更推荐使用网页工具一键转换。 比如https://markdown-convert.com/zh/tool/table

参考资料

Markdown-Wikipedia:https://zh.wikipedia.org/wiki/Markdown

Markdown 基本语法:https://github.com/younghz/Markdown

评论已关闭