Hexo-renderer-marked 项目常见问题解决方案

Hexo-renderer-marked 项目常见问题解决方案

hexo-renderer-marked Markdown renderer for Hexo 项目地址: https://gitcode.com/gh_mirrors/he/hexo-renderer-marked

基础介绍

Hexo-renderer-marked 是一个用于 Hexo 的 Markdown 渲染器，它使用 marked 作为其渲染引擎，支持 GitHub 风格的 Markdown 语法。该项目主要使用 JavaScript 编程语言。

新手常见问题及解决步骤

问题一：如何安装 Hexo-renderer-marked？

解决步骤：

1. 确保你的系统中已经安装了 Node.js。
2. 在你的 Hexo 项目根目录下打开命令行工具。
3. 执行以下命令安装 Hexo-renderer-marked：

   npm install hexo-renderer-marked --save
   

问题二：如何配置 Hexo-renderer-marked？

解决步骤：

1. 打开你的 Hexo 项目的 _config.yml 文件。
2. 在文件中找到或添加 marked 配置部分。
3. 根据你的需求配置相关选项，例如：

   marked:
     gfm: true
     pedantic: false
     breaks: true
     smartLists: true
     smartypants: true
     quotes: '“”‘’'
     ...
   

4. 保存 _config.yml 文件并重新启动 Hexo 服务器。

问题三：如何处理潜在的 XSS 攻击？

解决步骤：

1. Hexo-renderer-marked 默认不启用 DOMPurify 清理渲染后的 HTML，这可能使你的网站容易受到 XSS 攻击。
2. 为了解决这个问题，你可以在 _config.yml 文件中的 marked 配置部分添加 dompurify: true 选项。
3. 由于启用 DOMPurify 可能会破坏标签插件（如 [% codeblock %]），你可能需要考虑迁移到默认安全的 hexo-renderer-markdown-it 渲染器。
4. 如果决定迁移，可以执行以下命令来卸载 Hexo-renderer-marked 并安装 hexo-renderer-markdown-it：

   npm uninstall hexo-renderer-marked
   npm install hexo-renderer-markdown-it --save
   

以上步骤可以帮助新手在使用 Hexo-renderer-marked 时避免常见的陷阱，并确保网站的 Markdown 渲染安全和高效。

hexo-renderer-marked Markdown renderer for Hexo 项目地址: https://gitcode.com/gh_mirrors/he/hexo-renderer-marked