如何在使用Jekyll的{% link %}标签时覆盖链接验证？

逐个案例跳过链接验证 #

如果只想在特定内容里允许断链，最直接的方式是放弃使用{% link %}和{% post_url %}标签，改用手动编写链接：

• 直接写相对路径或绝对路径，比如 /posts/missing-post.html
• 或者用HTML链接标签：<a href="/pages/non-existent-page">待补充页面</a>
  这类手动链接不会触发Jekyll的存在性验证，自然不会因断链终止构建。

如果想保留类似标签的写法，也可以自定义简化版Liquid标签去掉验证逻辑：在_plugins目录下创建custom_link.rb文件，内容如下：

module Jekyll
  class CustomLinkTag < Liquid::Tag
    def initialize(tag_name, path, tokens)
      super
      @path = path.strip
    end

    def render(context)
      # 直接返回路径，不做存在性验证
      @path
    end
  end
end

Liquid::Template.register_tag('custom_link', Jekyll::CustomLinkTag)

之后在文档中用{% custom_link /missing-page.html %}代替{% link %}即可。

_config.yml 全局设置 #

Jekyll本身没有专门配置项关闭link/post_url的链接验证，不过可以通过构建参数间接调整：

• 使用jekyll build --skip-initial-build仅跳过初始构建的部分检查，但无法完全避免断链终止问题；
• strict_front_matter: false仅针对front matter错误生效，不影响链接验证。

插件方案 #

可以使用第三方插件忽略断链错误，比如jekyll-allow-broken-links（需自行安装），这类插件会拦截Jekyll的链接验证错误，确保构建完成。不过个人站点使用时，手动替换链接的方式更轻量，无需额外依赖。

内容的提问来源于stack exchange，提问作者the_meter413