前言
在前端开发中，我们经常需要编写文档来记录项目中的信息和细节，而 Markdown 是一种方便易读易写的文本格式，被越来越多的人采用。但是，在编写 Markdown 文档时，我们常常需要手动添加图片和代码片段，这会耗费大量的时间和精力。
而 mdify-node 就是为了解决这个问题而生的，它是一个自动化处理 Markdown 文档的工具，可以自动添加图片和代码片段，让你更专注地编写文档内容。
本篇文章将详细介绍 mdify-node 的使用方法，帮助你更好地利用它来提高 Markdown 编写效率和质量。
安装
首先，你需要安装 Node.js 和 npm，这两个工具可以让你在本地开发和运行 JavaScript 应用程序。
然后，使用以下命令来安装 mdify-node：
--- ------- ---------- ----------
使用方法
安装成功后，你可以在项目的根目录中创建一个 docs 文件夹，在其中编写 Markdown 文档。然后，使用以下命令来运行 mdify-node：
--- ----------
这个命令会自动扫描 docs 文件夹，将其中的 Markdown 文件进行处理，并输出到 docs-built 文件夹中。
下面，我们来看一些 mdify-node 的常用选项和配置。
自定义语言
如果你在 Markdown 文档中使用了代码块，可以使用 lang 来指定代码的语言，例如：
------------- ------------------- ---------
这里我们指定了代码的语言为 JavaScript，这样可以让代码块更容易阅读和理解。
添加图片
在 Markdown 文档中添加图片时，你需要将图片文件复制到 docs 文件夹下，并使用相对路径来引用，例如：
---- -----------------------------
这样，mdify-node 就可以将图片复制到生成的 docs-built 文件夹中，并在 Markdown 文档中自动加上图片链接。
添加代码片段
在 Markdown 文档中添加代码片段时，你可以引用其他的 Markdown 文件或者代码文件，例如：
----------- -----------------
-- -- ---------- ------ ------------- ----- --- - --------------------- ------------
这样，mdify-node 就可以将引用文件中的代码块复制到生成的 docs-built 文件夹中，并在 Markdown 文档中自动加上代码块链接。
自定义 CSS 样式
如果你想自定义生成的 HTML 文件的样式，可以在 docs 文件夹中创建一个名为 style.css 的文件，并在其中编写自定义 CSS 样式。然后，在运行 mdify-node 命令时，指定 --style 选项来使用该 CSS 文件，例如：
--- ---------- ------------------------
这样，mdify-node 就会将指定的 CSS 文件复制到 docs-built 文件夹中，并将生成的 HTML 文件链接到该文件。
生成 PDF 文件
如果你需要生成 PDF 格式的文档，可以使用 Pandoc 将生成的 HTML 文件转换为 PDF 文件。你需要先安装 Pandoc，然后使用以下命令将 HTML 文件转换为 PDF 文件：
------ -- -- --------------- ----------------
示例代码
下面是一个简单的示例代码，演示了如何使用 mdify-node：
- -- -------- -- ------ -------- --- -- --------- ------------- ---- ----------------------------- ------------- ------------------- ---------
添加链接
这里是一些链接：
自定义样式
这里是自定义样式的一个示例：
---- - ----------------- -------- ------------ ---------- ------ ---------- ------ ----------- -
生成 PDF 文件
你可以使用 Pandoc 将生成的 HTML 文件转换为 PDF 文件：
------ -- -- --------------- ----------------
谢谢阅读！
-- -- ---------- ---------- ----------------------------------------- ---------- --- -------- -------- ------------------------------------- --------------------- ------------------------------------------------------------------------------ ---------- -----------------------------------------------------------------------------------------------------------------------------