vuepress

vuepress copied to clipboard

Feature request

What problem does this feature solve?

What does the proposed API look like?

How should this be implemented in your opinion?

Are you willing to work on this yourself?

## 什么是 Vue？ {#what-is-vue}

标题可以自定义id，## 标题一

目前我也遇到了这个问题，我是使用的是vuepress 1.x，我也尝试使用了{#English-name}的语法，但是不奏效，因此我只能修改源代码才能解决，我在配置里面添加了这个：(vuepress没有内置，你需要安装如下相应的包)

markdown: {
        extendMarkdown: (md) => {
            // 使用 markdown-it-anchor
            md.use(require("markdown-it-anchor"));
            // 使用 markdown-it-attrs（用于解析{#attr}的内容）
            md.use(require("markdown-it-attrs"), {
            // 这里可以设置 markdown-it-attrs 的选项
            });
        },
    },

这样子就可以解析{#English-name}里面的内容了，而且锚点可以生效。 但是还有一个问题，那就是目录生成以及搜索匹配不是使用的是这个解析逻辑，因此自动生成的目录还会显示花括号的内容，那么你需要修改搜索插件plugin-search的源代码和主题内navbar.vue的生成逻辑代码，在生成结果时，将数据使用正则表达式过滤，才能得到你需要的内容。

过程太复杂了，不知道官方几百个issue管都不管，实在不行我还是用Typecho或者自己flask写一个文档解析站，实在不行我就干脆用语雀算了，连docsify都清楚使用标题的解析中文放在地址栏十分突兀。

光这个问题我折腾了半天，现在又要折腾用户自定义插件引入只有最后一个插件生效的问题，实在不行我就只能弃坑了。

@yuansky88 我是用 VitePress v1.0.0-rc.X。

@yuansky88 我是用 VitePress v1.0.0-rc.X。

我刚开始也准备开始使用VitePress，但是没有中文文档，我想想还是算了 : )