编写文档

每个文档都需要使用 Markdown 语法编写，GitHub Flavored Markdown 规范当中的大部分功能也已通过 yuin/goldmark 实现。

如下所示：

---
title: 项目介绍
---

_**一魂文档**_ 是一款支持多语言的 Web 文档服务器。

前置配置是指每个文档的开头部分使用 --- 包括的 YAML 代码块。

下面展示了目前支持的所有前置配置字段：

title: 文档标题
previous:
  title: 前个页面的标题
  link: 前个页面的相对路径
next:
  title: 后个页面的标题
  link: 后个页面的相对路径

指向其它文档或图片的链接与任何编辑器中的语法并无二致（如 VSCode）：

代码块的高亮使用 alecthomas/chroma 实现，因此需要使用其支持语言（英文）列表中的名称来指定代码块的语言，名称中的空格需要使用横线 (-) 替代，如使用 go-html-template 而不是 go html template（大小写不敏感）。

代码块还支持行数显示和多行高亮：

...go-html-template {linenos=true, hl_lines=["7-10", 12]}

当服务器使用默认配置运行时（dev 环境），每个请求都会重新加载并渲染文档页面：

ENV = dev

在生产环境需要通过配置 ENV = prod 启用渲染缓存。