前言
snuff 是一个快速生成静态 HTML 文件的命令行工具，它可以方便地将 Markdown 文件或者其他格式的文档转换为 HTML 文件。它也可以通过使用模板文件来自定义 HTML 文件的生成规则。snuff 还提供了便捷的本地预览、开发调试以及发布上线等功能，是一个非常实用的前端工具。
安装 snuff
使用 snuff 需要先在本地安装 Node.js 环境，并通过 npm 安装 snuff。
npm install -g snuff
安装完成后，可以通过以下命令测试是否安装成功：
snuff --version
如果出现版本号，说明 snuff 安装成功了。
使用 snuff
基本用法
snuff 的基本用法非常简单，只需要在命令行中输入以下命令：
snuff path/to/source/file path/to/target/file
其中 path/to/source/file 是源文件的路径，path/to/target/file 是生成的 HTML 文件的路径。
Markdown 转换为 HTML
如果你想将 Markdown 文件转换为 HTML 文件，可以使用以下命令：
snuff README.md README.html
其中 README.md 是 Markdown 文件的路径，README.html 是生成的 HTML 文件的路径。这样就可以将 Markdown 文件转换为 HTML 文件了。
自定义模板
如果你想自定义生成的 HTML 文件的格式，可以使用模板文件。
snuff 会读取模板文件并将其与 Markdown 文件生成的 HTML 文件合并。模板文件中使用 Handlebars 语法，可以自定义 HTML 文件的头部、脚本、样式等部分。
例如，假设你有一个模板文件 index.hbs，其中包含以下内容：
-- -------------------- ---- -------
--------- -----
------
------
--------- ----- ----------
-------
------
---- ------------------
--- ------- ---
------
-------
-------这个模板文件定义了一个 HTML 页面的结构，使用了 Handlebars 语法，其中 {{{ content }}} 是将生成的内容插入到模板中的占位符。
现在假设你有一个 Markdown 文件 README.md，其内容如下：
# Hello, World! This is my first snuff file.
那么你可以使用以下命令来将 README.md 文件转换为带有模板的 HTML 文件：
snuff README.md -t index.hbs -o README.html
其中，-t 参数指定了模板文件的路径，-o 参数指定了输出文件的路径。生成的 HTML 文件的头部将包含 title 标签，其内容为 README.md 文件的标题。
本地预览
snuff 提供了方便的本地预览功能，可以在本地查看生成的 HTML 文件。只需要在命令行中输入以下命令：
snuff path/to/source/file --preview
其中，path/to/source/file 是源文件的路径。这样就可以在本地预览 HTML 文件了。
开发调试
snuff 还提供了方便的开发调试功能，可以自动编译 Markdown 文件并生成 HTML 文件。只需要在命令行中输入以下命令：
snuff path/to/source/file --watch
其中，path/to/source/file 是源文件的路径。这样就可以在本地自动编译 Markdown 文件并生成 HTML 文件了。
发布上线
如果你想在网站上发布静态 HTML 文件，可以使用 GitHub Pages、Netlify 等静态网站托管服务。只需要将生成的 HTML 文件提交到 GitHub 或者其他静态网站托管服务，就可以在网站上访问了。
总结
snuff 是一个非常实用的前端工具，可以快速生成静态 HTML 文件，帮助开发者快速创建网站或者文档。通过本文的介绍，你已经了解了 snuff 的基本用法和高级功能，希望对你有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055cb581e8991b448da2bb