# Markdown 基本语法

By [mtoto.eth](https://paragraph.com/@mtoto) · 2022-01-09

---

这篇文章提供了可以在 Hugo 的文章中使用的基本 Markdown 语法示例.

注意

这篇文章借鉴了一篇很棒的[来自 Grav 的文章](http://learn.getgrav.org/content/markdown).

如果你想了解 **Loveit** 主题的扩展 Markdown 语法, 请阅读[扩展 Markdown 语法页面](http://192.168.0.120:8000/theme-documentation-content#extended-markdown-syntax).

事实上, 编写 Web 内容很麻烦. **WYSIWYG所见即所得** 编辑器帮助减轻了这一任务. 但通常会导致代码太糟, 或更糟糕的是, 网页也会很丑.

没有通常伴随的所有复杂和丑陋的问题, **Markdown** 是一种更好的生成 **HTML** 内容的方式.

一些主要好处是:

1.  Markdown 简单易学, 几乎没有多余的字符, 因此编写内容也更快.
    
2.  用 Markdown 书写时出错的机会更少.
    
3.  可以产生有效的 XHTML 输出.
    
4.  将内容和视觉显示保持分开, 这样就不会打乱网站的外观.
    
5.  可以在你喜欢的任何文本编辑器或 Markdown 应用程序中编写内容.
    
6.  Markdown 使用起来很有趣!
    

John Gruber, Markdown 的作者如是说:

> Markdown 格式的首要设计目标是更具可读性. 最初的想法是 Markdown 格式的文档应当以纯文本形式发布, 而不会看起来像被标签或格式说明所标记. 虽然 Markdown 的语法受到几种现有的文本到 HTML 转换工具的影响, 但 Markdown 语法的最大灵感来源是纯文本电子邮件的格式.
> 
> – _John Gruber_

话不多说, 我们来回顾一下 Markdown 的主要语法以及生成的 HTML 样式!

技巧 将此页保存为书签，以备将来参考! 1 标题 从 h2 到 h6 的标题在每个级别上都加上一个 ＃:

1 2 3 4 5

h2 标题
-----

### h3 标题

#### h4 标题

##### h5 标题

###### h6 标题

输出的 HTML 看起来像这样:

1 2 3 4 5

h2 标题
-----

### h3 标题

#### h4 标题

##### h5 标题

###### h6 标题

标题 ID 要添加自定义标题 ID, 请在与标题相同的行中将自定义 ID 放在花括号中:

1

### 一个很棒的标题 {#custom-id}

输出的 HTML 看起来像这样:

1

### 一个很棒的标题

---

*Originally published on [mtoto.eth](https://paragraph.com/@mtoto/markdown)*