Markdown链接换页后为何失效?

KKCE 编辑团队 Markdown转HTML

内容摘要

Markdown转成HTML之后,链接仍可能因发布目录不同而指向错误位置。转换器负责生成标记,链接最终去哪里还取决于页面的基准地址。排查时应同时保留原始写法、生成的href与浏览器解析后的目标。

Markdown转成HTML之后,链接仍可能因发布目录不同而指向错误位置。转换器负责生成标记,链接最终去哪里还取决于页面的基准地址。排查时应同时保留原始写法、生成的href与浏览器解析后的目标。

Markdown链接换页后为何失效?:KKCE官网演示
KKCE官网本轮演示实拍,输入为构造样本;结果与可见字段以截图当时为准。

先看生成的属性,而非点击感觉

本次在KKCE转换页输入[工具入口](http.html),观察生成HTML中的href。这个写法没有包含站点根路径,也没有提供完整主机地址,因此不是一个固定的绝对目标。工作区预览可以帮助检查链接标记,却不能替未来的文章目录、知识库路径或部署前缀作出决定。

目录改变会怎样影响解析

同一段href="http.html"放在站点根页面与多层目录页面中,浏览器计算出的地址可能不同。若站点还设置了base元素,解析依据又可能变化。问题往往出在发布环境,而不在Markdown语法本身。应查看页面实际地址和基准地址,再判断是否需要站点根相对路径或完整站内地址,不要只在编辑器里连续转换几次。

在文章、静态导出与预览中各测一次

CMS预览路径可能与正式页面不同,离线导出又可能采用本地文件目录。发布前准备一张链接清单,包含目标含义、当前写法和正式环境预期位置。对页面内锚点,还要确认标题生成的标识是否由模板改变。对图片也应使用相同思路,区分文件是否确实存在与路径是否正确解析。

修复后核对实际到达的内容

链接能返回页面并不自动说明目标正确,它也可能进入了兜底页、登录页或与预期不同的栏目。应在正式页面检查最终地址、跳转过程及目标内容。KKCE的转换工作区适合核对标记输出,网站测速等功能可以补充观察访问响应,但业务链接验收仍要核实读者到达的是不是指定功能页。

演示说明:文中相对地址是构造样例;发布正文中的实际功能入口使用KKCE本站完整地址。

功能入口:Markdown转HTML。