How_to_hugo

1. Markdown 5分钟使用指南

注意: 该主题的toc渲染有点问题,不支持1.1.1 这种表达(和 visual studio code 里面冲突)

1.1. Why Markdown

Markdown is a lightweight markup language that you can use to add formatting elements to plaintext text documents.

Markdown 本质上就是一种标记语言,让你在不需要过度关注文章结构的同时,提供了符合逻辑的文章结构。

How to Markdown

正如以上所说,Markdown 只是为了让你更舒服的组织好文章架构,那么从以下几个方面来使用则很符合逻辑。

1.2.1. 结构

Markdown 把一篇文章分为如下结构:

一级标题只能有一个,等价于文章的标题,所有其他等级标题都在一级标题下面。

1.2.2. 段落

正文直接手写就行。

1.2.2.1. 分隔符

如下:


1.2.2.2. 引用

这样就可以引用别人的话。

引用功能可以嵌套。

哈哈

1.2.2.3. 代码块

1.2.2.3.1. 单行代码

单行代码可以这么写:def

1.2.2.3.2. 多行代码

多行代码一样的,同时在后接 python 等可以支持不同语法的代码高亮。

def hello_world():
    """
    代码里面就一样的
    """
    pass

1.2.3. 句子

1.2.3.1. 换行

Markdown 的换行有点傻逼。
可以这么换(貌似没有更好的解决办法)

1.2.3.2. Bullet Dot

1.2.4. 文本

文本的内容就比较有趣了。
比方说可以加粗,可以划去内容,可以 斜体字 ,也可以下划线

1.2.4.1. 链接

可以直接这样

图片的话:
图片

1.3. Others

1.3.1. 杂