hexo默认处理heading的标题为id的异常解决方案

Thu, 29 May 2025 17:08:34 +0000

hexo在处理markdown文档的时候，默认将heading的内容作为了id来处理锚点，如果是英文是没有问题的。

## 我的标题

处理后的html内容

<h2 id="我的标题"><a href="#我的标题" class="headerlink" title="我的标题"></a><a href="#我的标题">我的标题</a></h2>

但是作为标题是中文的话就会有问题，以为在js的代码中，id是中文是不支持的，这会导致很多js库无法正常运行

找了很多资料，其中就有安装hexo-renderer-markdown-it

但是我自己亲自测试下来，还是很复杂，然后也没有解决我的问题，于是我思考这个hexo不会烂到这个程度吧

于是我看到了一种写法

## [我的标题](#custom-id)

处理后的html内容

<h2 id="custom-id"><a href="#custom-id" class="headerlink" title="我的标题"></a><a href="#custom-id">我的标题</a></h2>

哎，可以，就这么轻松的解决了，不需要什么卸载安装什么的

Hello World

Wed, 28 May 2025 16:10:14 +0000

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

$ hexo new "My New Post"

More info: Writing

Run server

$ hexo server

More info: Server

Generate static files

$ hexo generate

More info: Generating

Deploy to remote sites

$ hexo deploy

More info: Deployment