Add MD052/reference-links-images and MD053/link-image-reference-definitions for reporting issues with link and image references (fixes #144, fixes #390, fixes #425, fixes #456).

2026-01-06 07:58:49 +01:00 · 2022-06-01 20:23:08 -07:00 · 2022-06-01 20:23:08 -07:00 · c5ca661b96
commit c5ca661b96
parent 2c947abf7b
21 changed files with 1333 additions and 65 deletions
--- a/test/reference-links-and-images.md
+++ b/test/reference-links-and-images.md
@ -0,0 +1,164 @@
+# Reference Links and Images
+
+## Valid Links
+
+Full reference link: [text][label]
+
+Collapsed reference link: [label][]
+
+Shortcut reference link: [label]
+
+Same line: [text][label] [label][] [label]
+
+Mixed case: [TEXT][LABEL] [LABEL][] [LABEL]
+
+With spaces: [text][label with spaces] [text][ label  with spaces ]
+
+With nested brackets: [t[ex]t][label]
+
+With inline content: [*text*][label]
+
+With inline code span: [`code`][label]
+
+Shortcut inline code span: [`code`]
+
+Multi-line full text: [multi
+line][multi line full text]
+
+Multi-line full label: [text][multi
+line full label]
+
+Multi-line collapsed label: [multi
+line collapsed label][]
+
+Multi-line shortcut label: [multi line
+shortcut label]
+
+Dedicated line:
+[text][label]
+
+Dedicated line with trailing colon:
+[text][label]:
+
+Shortcut ending in colon: [colon]:
+
+Use of multi-line label: [multi-line-label][]
+
+Standard link: [text](https://example.com/standard)
+
+## Invalid Links
+
+Missing label: [text][missing] {MD052}
+
+Mixed valid/invalid: [text][label] [text][missing] {MD052}
+
+Missing multi-line label {MD052}: [text][missing
+label]
+
+## Non-Links
+
+Space: [text] [wrong]
+
+Empty: [text][ ]
+
+Code span: `[text][wrong]`
+
+Escaped left text: \[text][wrong]
+
+Escaped right text: [text\][wrong]
+
+Escaped left label: [text]\[wrong]
+
+Escaped right label: [text][wrong\]
+
+## Valid Images
+
+Full style: ![text][image]
+
+Collapsed style: ![image][]
+
+Shortcut style: ![image]
+
+Image in link: [![text][image]][label] [![image][]][label] [![image]][label]
+
+## Invalid Images
+
+Image only: ![text][missing] {MD052}
+
+Image in link: [![text][missing]][label] {MD052}
+
+## Non-Images
+
+Escaped left text: !\[text][wrong]
+
+Escaped right text: ![text\][wrong]
+
+Escaped left label: ![text]\[wrong]
+
+Escaped right label: ![text][wrong\]
+
+## Valid Footnotes
+
+Footnote[^1]
+
+## Invalid Footnotes
+
+Missing[^2]
+
+## Valid Labels
+
+[label]: https://example.com/label
+[ label with  spaces ]: https://example.com/label-with-spaces
+[image]:https://example.com/image
+[`code`]: https://example.com/code
+[^1]: https://example.com/footnote
+[multi line full text]: https://example.com/multi-line-full-text
+[multi line full label]: https://example.com/multi-line-full-label
+[multi line collapsed label]: https://example.com/multi-line-collapsed-label
+[multi line shortcut label]: https://example.com/multi-line-shortcut-label
+[colon]: https://example.com/colon
+[multi-line-label]:
+https://example.com/multi-line-label
+
+## Invalid Labels
+
+Duplicate:
+[label]: {MD053}
+
+Unused:
+[unused]: {MD053}
+
+Unused footnote:
+[^3]: {MD053}
+
+[Duplicate unused multi-line label {MD053}]:
+https://example.com/duplicate-unused-multi-line-label
+
+[Duplicate unused multi-line label {MD053}]:
+https://example.com/duplicate-unused-multi-line-label
+
+\[Escaped left]: text
+
+[Escaped right\]: text
+
+## Valid Links and Images after Labels
+
+Link and image: [text][label] [![text][image]][label]
+
+## More Invalid Links and Images after Labels
+
+Bad link with image [![text][image]][missing] {MD052}
+
+## Shortcut One-Way Handling
+
+Validates the label: [shortcut]
+
+[shortcut]: https://example.com/shortcut
+
+Not flagged due to ambiguity: [ignored]
+
+## Open Bracket Pairs
+
+Unmatched [ in text
+
+Hidden reference: [hidden][] {MD052}