Markdown语法总结

认识 Markdown

Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。目前来看，支持 Markdown 语法的编辑器有很多，包括很多网站（例如 BLOG ）也支持了 Markdown 的文字录入。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式。

Markdown 的优点

  • 页面内容可读性强，简洁直观。

  • 纯文本，兼容性强，几乎任何文本编辑器都可打开。

  • 格式转换简便，轻松的导出.HTML、.PDF、.MD等多种格式文件。

  • 不需太过于关心页面排版，只需关注内容。

Markdown 官方文档

常用的Markdown工具

MacDown logo

MacOS平台(个人推荐使用Macdown)

在 Mac OS X 上，个人强烈建议使用 Macdown 这款免费且十分好用的 Markdown 编辑器，它支持实时预览，即，左边是你编辑 Markdown 语言，右边会实时的生成预览效果。

Macdown

Windows平台

Windows用户建议尝试以下两款产品：

  • MarkdownPad

  • MarkPad

Markdown 语法的简要介绍

换行符

在Markdown语法中，换行需要敲两个回车键，即在两段文本之间添加一个空行来达到换行的效果。

  1. 敲一个回车键

    代码展示：

    1
    2
    这是第一个段落
    这是第二个段落

    效果展示：

    这是第一个段落
    这是第二个段落

    上面的写法在Macdown编辑器中显示是两行，但是在预览效果发现，他们还是在同一行，只是两个段落中间多出来一个空格，这时我们在两行中间多敲一个回车键就能达到换行的效果。

  2. 敲两个回车键

    代码展示：

    1
    2
    3
    这是第一个段落

    这是第二个段落

    效果展示：

    这是第一个段落

    这是第二个段落

    有同学发现，我本来只是想让同一句话换个行显示而已，你这中间还多出来一空行，不够美观。能不能中间没有留白的空行，但是也能实现换行的效果尼？当然办法总是有的，下面就介绍第二种换行方式。

官方解释：To force a line break, put two spaces and a newline (return) at the end of the line.

  1. 在同一段落中需要换行的字符后敲两个空格，再敲回车键就能达到同一段落换行的效果

    代码展示：

    1
    2
    这是第一个段落  
    这是第二个段落

    效果展示：

    这是第一个段落
    这是第二个段落

强调

在Markdown语法中，想要着重强调某一部分内容时，可以使用*或者是_来包裹要着重强调的内容。**或__表示字体加粗，*或_表示字体斜体，（个人推荐使用*）

这里的内容强调分两种语法，一种是加粗强调，另一种是为斜体强调

  1. 加粗（也可以使用快捷键生成加粗符号：Command+b）

    代码展示：

    1
    2
    **OurStar**  
    __OurStar__

    效果展示：

    OurStar
    OurStar

  2. 斜体（也可以使用快捷键生成斜体符号：Command+i）

    代码展示：

    1
    2
    *OurStar*  
    _OurStar_

    效果展示：

    OurStar
    OurStar

标题

在Markdown语法中，添加标题使用#，就会有标题加粗的效果出现。标题分为六个等级，即1个#代表一级标题，2个#代表二级标题，直到六级标题。

代码展示：

1
2
3
4
5
6
7
8
9
10
11
# Header 1

## Header 2

### Header 3

#### Header 4

##### Header 5

###### Header 6

也可以使用下面的方式来设置一级、二级标题，不过不推荐使用。

代码展示：

1
2
3
4
5
Header 1
========

Header 2
---------

URL链接

在写自己的博客中，经常有需求要跳转到某一个网页或者邮件。这时需要使用link链接。link链接方式分为内联(Inline)和外部引用(Reference)

  • Inline

    将邮箱地址包裹在<>内部，就形成了可以点击的邮箱地址: public@ourstar.top

    代码展示：

    1
    <public@ourstar.top>

    将网页url包裹在<>内部，就形成了可以点击访问的网页地址: https://blog.ourstar.top

    代码展示：

    1
    <https://blog.ourstar.top>

    自定义网页链接的标题[标题](链接): OurStar

    代码展示：

    1
    [OurStar](https://blog.ourstar.top)

  • Reference (外部引用的好处可以在整个文章中重复引用网页地址或者图片地址不需要重复拷贝同一个url)

    代码展示：

    1
    2
    3
    4
    [arbitrary_id]: https://blog.ourstar.top  
    [a_link][arbitrary_id]  
    [b_link][arbitrary_id]  
    [c_link][arbitrary_id]

    效果展示：

    a_link
    b_link
    c_link

引用图片

Markdown中引用图片资源同样也是分为内联(Inline)和外部引用(Reference)

  • Inline

    代码展示：

    1
    ![Alt Image Text](/img/in-post/241202/Example.webp)

    效果展示：

    Alt Image Text

  • Reference (同上，好处也是不用重复拷贝一个链接)

    代码展示：

    1
    2
    3
    4
    [image-id]: https://cdn.ourstar.top/img/241203-WeChat.png
    ![1][image-id]
    ![2][image-id]
    ![3][image-id]

    效果展示：

    1
    2
    3

列表

Markdown语法中，列表分为三类：有序列表、无序列表、嵌套列表

  • 有序列表

    1
    2
    3
    1. 列表1
    2. 列表2
    3. 列表3

  • 无序列表(无序列表中，*、+、-效果一样，个人推荐使用*)

    1
    2
    3
    4
    5
    6
    7
    8
    * 列表1
    * 列表2

    + 列表4
    + 列表5

    - 列表7
    - 列表8

  • 缩进层次嵌套列表

    1
    2
    3
    4
    * 这是一个嵌套列表
      1. 列表1
      2. 列表2
      3. 列表3

引用

Markdown语法中，使用>表示引用，引用名人名言或者是别人的一段文本等。

  1. 代码展示：

    1
    > "三天不学习，赶不上刘少奇。" - 毛泽东

    效果展示：

“三天不学习，赶不上刘少奇。” - 毛泽东

  1. 当然引用也可以嵌套使用的

    代码展示：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    > 这是一级引用
    >
    > > 这是二级引用
    > >
    > > > 这是三级引用  
    > > > 还是三级引用

    >> 这是二级引用

    > 这是一级引用

    效果展示：

这是一级引用

这是二级引用

这是三级引用
还是三级引用

这是二级引用

这是一级引用

  1. 引用也可以和其他的markdown语法混合使用

    代码展示：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    > `这是一级引用`
    >
    > > *这是二级引用*
    > >
    > > > * 这是三级引用  
    > > > * 还是三级引用
    > > >
    > > > 1. 还是三级标题
    > > > 2. 还是三级标题

    >> **二级引用**

    > [一级引用](https://blog.ourstar.top)

    效果展示：

这是一级引用

这是二级引用

  • 这是三级引用
  • 还是三级引用
  1. 还是三级标题
  2. 还是三级标题

二级引用

一级引用

内嵌文本 InlineCode

  • 当我们想让某一文本内容内嵌在边框内，我们可以使用一对反引号包裹内容

    代码展示：

    1
    `测试文字`

    效果展示：

    测试文字

  • 当文本内容中正好包含有反引号，这时需要使用空格隔开

    代码展示：

    1
    2
    3
    ``code has `backticks` ``
      
    ```` ``Code with `backticks` `` ````

    效果展示：

    code has `backticks`

    ``Code with `backticks` ``

代码块 CodeBlock

三个反引号或者三个波浪号。

  • 方式 1

    1
    2
    3
    ```
    code
    ```

  • 方式 2

    1
    2
    3
    ~~~
    code
    ~~~

    注意切换到英文输入法哦~

分割线

当我们想对文章的某些内容做上下分割，这时我们可以使用分割线语法，有两种表达方法：

代码展示：

1
2
3
4
5
***

or

---

效果展示：

or

表格

表格的使用肯定我们每一位同学都不陌生，因为我们经常使用Excel表格来展示各种数据报表。很庆幸Markdown同样也支持表格制作，而且使用方式很简单。表格由行与列组成，这里只需要注意表格的内容对齐方式即可。

  1. 没有设置对齐方式

    代码展示：

    1
    2
    3
    4
    First Header  | Second Header
    ------------- | -------------
    Content Cell  | Content Cell
    Content Cell  | Content Cell

    效果展示：

    First Header Second Header
    Content Cell Content Cell
    Content Cell Content Cell

  2. 设置表格对齐

    代码展示：

    1
    2
    3
    4
    5
    | Left Aligned 居左对齐 | Center Aligned 居中对齐 | Right Aligned 居右对齐 |
    | :-------------------- | :---------------------: | ---------------------: |
    | col 3 is              |     some wordy text     |                  $1600 |
    | col 2 is              |        centered         |                    $12 |
    | zebra stripes         |        are neat         |                     $1 |

    效果展示：

    Left Aligned 居左对齐 Center Aligned 居中对齐 Right Aligned 居右对齐
    col 3 is some wordy text $1600
    col 2 is centered $12
    zebra stripes are neat $1

    这里需要注意：表格的左边和右边的|可以省略不需要使用，表格左右两边加上|主要基于美观考虑，表格的对齐方式仅仅取决于:

锚点

在写文章时，有时候我们有这样的需求，从文章的某一个位置直接跳转到指定的另一个位置，这时使用到a标签的锚点语法。

使用方式：

在待跳转到的位置上添加一行：

1
<a name="markdown-anchor"></a>

在需要跳转处使用：

1
[`认识 Markdown`](#markdown-anchor)

例如：本文中我添加到了认识 Markdown处

del标签

作用是在内容中间添加一条删除线

代码展示：

1
2
3
4
5
<del>xxx</del>

or

~~xxx~~

效果展示：

xxx

or

xxx

u标签

作用是在内容底部添加一条横线

代码展示：

1
<u>xxx</u>

效果展示：

xxx

mark标签

作用是对内容颜色进行高亮处理

代码展示：

1
<mark>xxx</mark>

效果展示：

xxx

font标签

作用是设置文本的字体颜色

代码展示：

1
<font color=Red>xxx</font>

效果展示：

xxx

总结

以上内容是作者花了N小时总结出来的常用Markdown语法，介绍了Markdown的十几种常用的语法知识，并逐一的进行了效果展示。可以说足以满足读者们日常中各种使用Markdown编写文章的需求。老铁们要是感觉文章对您有帮助，请多多鼓励哦～

最后最重要的一点：趁热打铁，温故知新！

强烈建议读者们认真浏览作者的这篇文章后，自己使用Markdown写一篇文章，体会一下Markdown语法的优雅之处！