玩转开源 | 搭建 Hugo 管理 Markdown 文档

在工作、学习中，不可避免会要写一些文档；又或者想搭建个简单网站，记录和分享您的生活经验或知识；撰写这些文档中使用 markdown 是一个非常不错的选择，让我们更加聚焦在文档表达的内容上。实际上笔者的文档基本都是在 Sublime 中用 markdown 格式撰写的。

在先前文章《Markdown的那些事儿》也有提到到，围绕 markdown 有着大量的开源软件、库做支持；这里分享下使用基于MIT许可证的开源软件 Hugo 来管理 Markdown 文档，能帮助基于 markdown 生成各种风格主题的静态页面。先不妨看下笔者一些markdown 文档效果：https://quincik.gitee.io/algorithms/docs/nine/array/

Hugo 常用来做什么？

Hugo是一款强大的用于生成静态网页的程序，擅长于将 Markdown 文档按需要转换成各类主题的静态网页；它由Go语言编写的，在处理速度上非常快；也有人对比过类似一些产品比如 Jekyll / Hugo / Hexo，其编译网页的速度是最快的。

使用Hugo的主要场景包括搭建公司、产品或个人网站，尤其是在结合云服务器的环境下。它的强大性不仅体现在速度上，也涵盖了灵活性和多样性。静态网页生成的成果可以轻松部署于GitHub Page、Gitee Page等平台，同时也能便捷地转换为各种主题形式，满足用户多样化的需求。

结合Hugo和Nginx的组合，可以迅速、高效地搭建公司站点或个人站点。这种方式不仅利用了Hugo快速生成静态网页的特性，还借助Nginx提供的高性能、稳定的Web服务器功能，为访问者提供了极佳的体验；最近，腾讯云服务器CVM推出了不少优惠活动，感兴趣的不妨试试。

搭建 Hugo 环境

第一步，安装 Go 语言环境，可以直接去官网下载下 GO 的程序，进行安装即可。附上官网安装链接：https://go.dev/doc/install

第二步，Hugo 经常会结合 Git 一起用，这里也安装 Git 的程序，同样也是推荐官方下载：https://git-scm.com/download/win

第三步，安装 Dart Sass， Hugo v0.114.0 以及后续版本是用Dart 来进行 Sass 的编译的；笔者是在 Windows 使用 Scoop 安装（其他系统可能更为方便），以下给出一些参考步骤：

先使用 win 自带的 PowerShell 来安装 Scoop

代码语言：java

复制

    # Optional: Needed to run a remote script the first time
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 
irm get.scoop.sh | iex</code></pre></div></div><ul class="ul-level-0"><li>使用 Scoop 安装 sass。	</li></ul><div class="rno-markdown-code"><div class="rno-markdown-code-toolbar"><div class="rno-markdown-code-toolbar-info"><div class="rno-markdown-code-toolbar-item is-type"><span class="is-m-hidden">代码语言：</span>java</div></div><div class="rno-markdown-code-toolbar-opt"><div class="rno-markdown-code-toolbar-copy"><i class="icon-copy"></i><span class="is-m-hidden">复制</span></div></div></div><div class="developer-code-block"><pre class="prism-token token line-numbers language-java"><code class="language-java" style="margin-left:0">scoop install sass</code></pre></div></div><p>当然这只是一种选择，也可以考虑直接去 github 上下载 release 安装，这里给的是 v1.69.5：https://github.com/sass/dart-sass/releases/tag/1.69.5</p><p><strong>第四步</strong>，安装 Hugo ，去 Github 上下载个最新版本安装即可，这里给的是 v0.120.4 ：https://github.com/gohugoio/hugo/releases/tag/v0.120.4</p><p>特别注意下以上的环境安装，记得都配置下 <strong>系统环境变量Path</strong> 方便后续的使用。最后附上，笔者安装的程序的 相关版本信息。</p><div class="rno-markdown-code"><div class="rno-markdown-code-toolbar"><div class="rno-markdown-code-toolbar-info"><div class="rno-markdown-code-toolbar-item is-type"><span class="is-m-hidden">代码语言：</span>text</div></div><div class="rno-markdown-code-toolbar-opt"><div class="rno-markdown-code-toolbar-copy"><i class="icon-copy"></i><span class="is-m-hidden">复制</span></div></div></div><div class="developer-code-block"><pre class="prism-token token line-numbers language-text"><code class="language-text" style="margin-left:0">PS D:\&gt; go version

go version go1.21.4 windows/amd64
PS D:&gt; git -v

git version 2.42.0.windows.2
PS D:&gt; sass --version

1.69.5
PS D:&gt; hugo version

hugo v0.120.4 ...