前言
在前端开发中，我们通常使用 Hexo 来搭建个人博客，而在博客编写过程中，我们经常会引用其他 Markdown 文件中的内容。这时，我们就需要用到 npm 包 hexo-include-markdown。本文将介绍这个包的使用方法及注意事项。
安装
在使用 hexo-include-markdown 之前，需要先安装到博客项目中：
npm install --save hexo-include-markdown
使用方法
在 Markdown 文件中使用 hexo-include-markdown 来引用其他 Markdown 文件中的内容，具体如下：
{% includeMarkdown path="path/to/file.md" %}其中，path 为被引用 Markdown 文件的相对路径。注意，引用的文件应当与当前文件在同一目录下或在更高级目录中。
例如，本文的示例代码所在路径为 ~/articles/hexo-include-markdown-tutorial，引用目标文件的路径为 ~/articles/hexo-tutorial/README.md，则引用语句为：
{% includeMarkdown path="../../hexo-tutorial/README.md" %}另外，hexo-include-markdown 还支持为被引用的 Markdown 文件设置标题、添加样式等操作，具体如下：
{% includeMarkdown path="path/to/file.md" %}
{#id} <!-- 添加 id -->
{#id .class1 .classs2} <!-- 添加 id 和 class -->注意事项
在引用过程中，有几个需要注意的点：
- 引用语句中的路径需要用双引号包裹
- 被引用的 Markdown 文件需要存在于本地磁盘中
- 引用过程中，被引用的 Markdown 文件中不支持 Hexo 标志，例如
{{ title }}
示例
以下是一个示例，用于展示 hexo-include-markdown 的具体应用。
例 1：描述你对 hexo-include-markdown 的看法。
我的看法如下：
{% includeMarkdown path="opinion.md" %}文件 opinion.md 的内容如下：
Hexo-include-markdown 是一款非常方便的 Hexo 插件，能够帮助用户快速引用其他 Markdown 文件的内容。尤其是在博客文章编写过程中，这个插件非常的实用。
例 2：在文章中引用一个代码片段。
以下是示例代码：
{% includeMarkdown path="code.md" %}文件 code.md 的内容如下：
```javascript
function hello() {
console.log('Hello, World!');
}可以看到，引用语句中使用 `includeMarkdown` 必须在 `{% ... %}` 中，且路径必须是被引用文件的相对路径。同时，如果被引用的 Markdown 文件中含有代码块等特殊内容，引用时需要正确进行转义和处理。
> 来源：[JavaScript中文网](https://www.javascriptcn.com/post/6005606781e8991b448de8a3) ，转载请注明来源
[https://www.javascriptcn.com/post/6005606781e8991b448de8a3](https://www.javascriptcn.com/post/6005606781e8991b448de8a3)