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

注意

这篇文章借鉴了一篇很棒的来自 Grav 的文章.

如果你想了解 Loveit 主题的扩展 Markdown 语法, 请阅读扩展 Markdown 语法页面.

事实上, 编写 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

输出的 HTML 看起来像这样:

1 2 3 4 5

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

1

输出的 HTML 看起来像这样:

1