Markdown
MarkdownLint 错误
Md053

MD053- 需要链接和图像参考定义

标签:imageslinks

别名:link-image-reference-definitions

参数:

  • ignored_definitions:忽略定义(string[]默认["//"]

可修复:一些违规行为可以通过工具修复

Markdown 中的链接和图像可以在使用时提供链接目标或图像源,也可以使用标签来引用文档中其他位置的定义。后一种参考格式可以方便地保持段落文本的整洁,并且可以轻松地在多个位置重复使用相同的 URL。

由于链接和图像引用定义与其使用位置分开,因此在两种情况下可能不需要定义:

  1. 如果文档中的任何链接或图像均未引用标签,则该定义未使用且可以删除。
  2. 如果一个标签在文档中定义了多次,则使用第一个定义,其他定义可以删除。

如果任何链接或图像引用具有相应的标签,则此规则考虑使用引用定义。“完整”、“折叠”和“快捷方式”格式均受支持。

如果存在故意不引用的引用定义,可以通过设置该ignored_definitions参数来忽略它们。此参数的默认值忽略向 Markdown 添加非 HTML 注释的以下约定:

[//]: # (This behaves like a comment)