正文

掌握Hexo：轻松实现公式渲染的详细指南，告别排版烦恼

/0 浏览量
1015

在撰写科学、数学或技术相关的内容时，公式的排版是至关重要的。对于使用Hexo构建静态博客的用户来说，内置的Markdown渲染引擎可能不支持公式的直接渲染。然而，通过一些插件和配置，我们可以轻松地实现公式渲染，让我们的Hexo博客支持LaTeX公式。下面，我就来详细介绍如何操作。

准备工作

在开始之前，请确保你已经安装了以下内容：

  1. Node.js和npm：Hexo是基于Node.js的，因此你需要安装Node.js以及npm。
  2. Git：Hexo需要使用Git进行版本控制。
  3. GitHub或GitLab账号：如果你打算将你的Hexo博客部署到GitHub Pages或GitLab Pages。

安装插件

Hexo支持多种插件，其中hexo-renderer-kramed插件可以增强Markdown的渲染能力，包括公式渲染。

首先，打开你的Hexo博客根目录，在终端中运行以下命令：

npm install hexo-renderer-kramed --save

配置_config.yml

安装完插件后，需要修改Hexo的配置文件_config.yml来启用公式渲染。

  1. 启用Kramed：在配置文件中找到markdown配置项，将其设置为kramed。
markdown:
  render:
    html: false
    toc: true
    mathjax: true
  1. MathJax路径：如果你没有使用CDN加载MathJax，需要指定MathJax的本地路径。在markdown配置项下添加以下内容：
mathjax:
  enable: true
 cdn: https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js

这里我们使用了CDN来加载MathJax，因为CDN加载速度更快，且无需担心本地文件更新问题。

写作公式

在Hexo中，你可以使用以下两种方式来编写公式：

1. 行内公式

使用$和$$包裹公式：

这是行内公式：$E=mc^2$

渲染结果：这是行内公式：(E=mc^2)

2. 居中公式

使用\[和\]包裹公式：

这是居中公式：
\[ E=mc^2 \]

渲染结果：这是居中公式：

[ E=mc^2 ]

部署博客

完成以上步骤后，你可以像往常一样部署你的Hexo博客：

hexo clean
hexo generate
hexo deploy

现在，你的Hexo博客应该可以渲染LaTeX公式了。

总结

通过安装hexo-renderer-kramed插件并配置MathJax，你可以轻松地在Hexo博客中实现公式渲染。这样，你就可以专注于内容的创作，而不用担心公式的排版问题。希望这篇文章能帮助你告别排版烦恼，专注于写作！

-- 展开阅读全文 --