markdown写作格式参考

NO.0 Markdown 基本语法与写作习惯养成 链接到标题

Markdown 基本语法可参考 markdown官网

部分常用语法 链接到标题

#标题1
##标题2
###标题3

**加粗文字**
*斜体文字*
***加粗斜体文字***

 - 列表1
 1. 列表2

> 引用

*** (分割线1)
--- (分割线2)

![图片名](图片链接)
[网站](网站链接)


Markdown 插入代码块:
    ```python
    #!/usr/bin/python3
    print("Hello, World!");
    ```

Markdown 段首缩进:
  or   表示一个半角的空格
  or    表示一个全角的空格
   两个全角的空格(用的比较多)
  or   不断行的空白格

写作习惯推荐 链接到标题

  • 好好排版
    • 中英文混用时,建议在英文单词前后加上空格方便阅读
    • 中英文逗号/句号等最好不要混用,强迫症震怒()

NO.1 认识 Hugo 文章开头的各项参数 链接到标题

参数参考

以上为本篇文章在终端中输入 Hugo new posts/Hugo文章写作指南.md 时自动生成的文章参数


draft = true 文章是否为草稿状态

  • true:草稿,Hugo默认不会生成/发布

    • 然而实际测试时,draft为true文章也正常发布了,待进一步测试中……
  • false:正式文章,会被发布


date = 2025-04-08T20:09:27+08:00 文章创建/发布时间

ps:本篇文章的时间在测试时被修改过

  • 格式:ISO 8601标准时间格式

  • +08:00表示东八区(中国时区)

  • 影响文章排序和发布时间判断


title = “Hugo文章写作指南” 文章标题(支持特殊字符和中文)

  • 会显示为文章页标题

slug = “1” 自定义URL路径

  • 留空时Hugo会从title自动生成

    • 像标题这样写,最后会显示为: slug1

    • 不填写,自动生成的显示结果: slug2


authors = [“NonoNoe”] 作者列表(数组格式)

  • 需要与config中定义的作者标识匹配

  • 支持多作者:[作者1, 作者2]

因为作者列表是数组格式,数组格式中的字符串一定要记得加引号,否则会报错


tags = [“Hugo”] 标签(同为数组格式)

  • 用于内容分类

  • 一篇文章可以有多个标签

如果里面需要填写中文字符串,也要记得加引号


categories = [] 分类目录(数组格式)

  • 比tags更宽泛的分类

  • 示例:[“技术”, “计算机图形学”]


externalLink = “” 外部链接(跳转URL用)

  • 设置后文章会直接跳转到指定链接

  • 留空表示正常生成文章页


series = [] 系列文章分组

  • 用于关联多篇系列文章

  • 示例:[“图形学入门”]

被关联的文章会显示在文章底部,如下所示

参考

Markdown 代码块与语法高亮


NO.2 发布 Hugo 文章的方式 链接到标题

hugo -D

文章草稿会被一起发布,去掉后缀则反之