本文针对 Markdown 文档中包含中文标点符号的锚点无法跳转的问题进行了排查。通过检查渲染后的 HTML 语句，发现生成的 id 属性中包含标点符号。经测试，在修改 Markdown 源码并移除锚点中的标点符号后，网址形式恢复正常，且可以成功跳转至对应位置。结论表明移除中文标点可解决该跳转失效问题。
本文解决了 Markdown 文档中点击锚点无法跳转的问题。作者在 PhpStorm 中发现锚点无法解析，通过 IDE 自动完成修正了链接。尽管在编辑器中仍提示无法解析，但调整锚点包含具体文本后，在 GitLab 平台点击锚点已能成功跳转至对应位置。文章最终建议锚点名称尽量使用英文以提升语义化。
👨💻 个人品牌
王世强｜技术实践者 · 独立博客作者
15+ 年 Web 与系统实践经验，持续关注网站基础设施、系统优化、AI 工具与自动化。
持续运营技术博客 10+ 年，累计发布 1000+ 篇原创技术文章。
长期建设个人项目，也欢迎合适的技术交流、咨询与合作。
.env (14) 404 (14) add (16) AI 翻译 (36) Array (19) A Tour of Go (78) CentOS (23) ChatGPT (31) ChatGPT Plus (18) chrome (19) Cloudflare (40) Codex (28) composer (42) composer.json (22) composer update (14) console (16) Container (25) curl (16) delete (31) Docker (33) Dockerfile (15) EdgeOne (35) environment variable (19) error (24) file (15) filter (20) Git (28) GitHub (23) Gitlab (15) GLM-5.2 (27) Go (85) go-tour-i18n (16) Google AdSense (30) Go 文档 (18) Go 语言 (24) GraphQL (24) GraphQL API (14) Gutenberg (36) http (21) https (23) Interface (19) json (24) Laravel (37) Laravel 6 (55) Laravel 9 (25) Lighthouse (17) Lighthouse 5 (14) Linux (22) Module (17) MySQL (78) MySQL 5.7 (22) Nginx (63) normalize.css (28) OKX (15) OneinStack (23) PHP (68) php-fpm (21) php.ini (24) PHP 7.1.12 (22) PHP 7.4 (26) phpmyadmin (15) PhpStorm (24) Polylang (59) postman (18) Query (17) queue (16) Rancher (24) Redis (53) RESTful (27) RESTful API (23) SEO (14) Shopify (19) SlyTranslate (22) SQL (24) String (14) TortoiseGit (14) Twenty Twenty-Five (20) Ubuntu (43) update (20) VPN (17) W3 Total Cache (41) Windows 10 (46) WireGuard (29) WordPress (136) WPCode (23) Wstunnel (16) Yii (40) Yii 2 (70) Yii 2.0 (51) ZgoCloud (14) 国际化 (17) 多语言翻译 (51) 开源项目 (16) 技术博客 (15) 故障排查 (20) 数据库迁移 (16) 本地化 (22) 浏览器 (14) 阿里云 (20) 页面缓存 (14)
