什么是 hexo-renderer-github？
hexo-renderer-github 是一款基于 Node.js 平台的 Hexo 插件，该插件可将 GitHub 上的 Markdown 文件渲染为 HTML，并且能够将代码段转换成对应的语言高亮的 HTML 代码。hexo-renderer-github 的使用可以方便我们在博客文章中直接使用 GitHub 上的 Markdown 文件，丰富我们的文章内容。
如何安装 hexo-renderer-github？
在命令行运行以下命令：
npm install hexo-renderer-github --save
将 hexo-renderer-github 安装到 Hexo 站点中。
在 Hexo 博客站点中的
_config.yml文件中添加以下配置：-- -------------------- ---- ------- --- - -------------------- -- --------- --------- ------ ------- ------ ----------------------------- - --------- --------- ---------------------- - ------- ------ --- -- ------------- ------------------------ - ------- ------ ---- ---
如何使用 hexo-renderer-github？
在 Hexo 博客文章中直接使用 GitHub 上的 Markdown 文件，只需在 Markdown 文章中添加以下语句：
{% github YOUR_GITHUB_USERNAME/YOUR_GITHUB_REPO_NAME@YOUR_GITHUB_BRANCH/PATH/TO/YOUR_MARKDOWN_FILE %}其中，YOUR_GITHUB_USERNAME 为你的 GitHub 用户名，YOUR_GITHUB_REPO_NAME 为你的 GitHub 代码库名称，YOUR_GITHUB_BRANCH 为你的代码库分支名称，PATH/TO/YOUR_MARKDOWN_FILE 表示你的 Markdown 文件在代码库的目录位置。
例如，以下语句用于将 https://github.com/hexojs/hexo-renderer-markdown 代码库中的 README.md Markdown 文件渲染为博客文章：
{% github hexojs/hexo-renderer-markdown@master/README.md %}示例代码
以下是一个简单的示例，展示如何使用 hexo-renderer-github 渲染 GitHub 上的 Markdown 文件：
---
title: "利用 hexo-renderer-github 渲染 GitHub 上的 Markdown 文件"
date: 2022-10-18
---
{% github hexojs/hexo-renderer-markdown@master/README.md %}通过以上示例代码，我们成功渲染了 https://github.com/hexojs/hexo-renderer-markdown 代码库中的 README.md 文件。
总结
通过本文的介绍，我们了解了 hexo-renderer-github 的安装和使用方式，以及如何将 GitHub 上的 Markdown 文件渲染到 Hexo 博客文章中。这些技巧对在博客文章中使用 GitHub 上的文章或者代码都具有指导意义，可以让我们的博客更加丰富多彩。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60067380890c4f72775841c5