markdownlint 0.26.1 → 0.26.2

package/README.md

@@ -48,6 +48,7 @@ and test cases came directly from that project.
   * [eslint-plugin-markdownlint for the ESLint analyzer](https://github.com/paweldrozd/eslint-plugin-markdownlint)
   * [grunt-markdownlint for the Grunt task runner](https://github.com/sagiegurari/grunt-markdownlint)
   * [Cake.Markdownlint addin for Cake build automation system](https://github.com/cake-contrib/Cake.Markdownlint)
+  * [Lombiq Node.js Extensions for MSBuild (.NET builds)](https://github.com/Lombiq/NodeJs-Extensions)
 * Ruby
   * [markdownlint/mdl gem for Ruby](https://rubygems.org/gems/mdl)
 
@@ -1020,6 +1021,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.
            browser script to use ES2015, simplify JSON schema, address remaining CodeQL issues,
            improve performance, update dependencies.
   * 0.26.1 - Improve MD051.
+  * 0.26.2 - Improve MD037/MD051/MD053.
 
 [npm-image]: https://img.shields.io/npm/v/markdownlint.svg
 [npm-url]: https://www.npmjs.com/package/markdownlint

package/demo/markdownlint-browser.js

@@ -1,4 +1,4 @@
-/*! markdownlint 0.26.1 https://github.com/DavidAnson/markdownlint @license MIT */
+/*! markdownlint 0.26.2 https://github.com/DavidAnson/markdownlint @license MIT */
 var markdownlint;
 /******/ (() => { // webpackBootstrap
 /******/ 	var __webpack_modules__ = ({
@@ -52,8 +52,11 @@ module.exports.listItemMarkerRe = /^([\s>]*)(?:[*+-]|\d+[.)])\s+/;
 module.exports.orderedListItemMarkerRe = /^[\s>]*0*(\d+)[.)]/;
 // Regular expression for all instances of emphasis markers
 const emphasisMarkersRe = /[_*]/g;
-// Regular expression for reference links (full and collapsed but not shortcut)
-const referenceLinkRe = /!?\\?\[((?:\[[^\]\0]*]|[^\]\0])*)](?:(?:\[([^\]\0]*)\])|[^(]|$)/g;
+// Regular expression for blockquote prefixes
+const blockquotePrefixRe = /^[>\s]*/;
+module.exports.blockquotePrefixRe = blockquotePrefixRe;
+// Regular expression for reference links (full, collapsed, and shortcut)
+const referenceLinkRe = /!?\\?\[((?:\[[^\]\0]*]|[^\]\0])*)](?:(?:\[([^\]\0]*)\])|([^(])|$)/g;
 // Regular expression for link reference definitions
 const linkReferenceDefinitionRe = /^ {0,3}\[([^\]]*[^\\])]:/;
 module.exports.linkReferenceDefinitionRe = linkReferenceDefinitionRe;
@@ -755,7 +758,7 @@ function getReferenceLinkImageData(lineMetadata) {
     // Define helper functions
     const normalizeLabel = (s) => s.toLowerCase().trim().replace(/\s+/g, " ");
     const exclusions = [];
-    const excluded = (match) => withinAnyRange(exclusions, 0, match.index, match[0].length);
+    const excluded = (match) => withinAnyRange(exclusions, 0, match.index, match[0].length - (match[3] || "").length);
     // Convert input to single-line so multi-line links/images are easier
     const lineOffsets = [];
     let currentOffset = 0;
@@ -763,6 +766,7 @@ function getReferenceLinkImageData(lineMetadata) {
     forEachLine(lineMetadata, (line, lineIndex, inCode) => {
         lineOffsets[lineIndex] = currentOffset;
         if (!inCode) {
+            line = line.replace(blockquotePrefixRe, "");
             if (line.trim().length === 0) {
                 // Allow RegExp to detect the end of a block
                 line = "\0";
@@ -813,30 +817,29 @@ function getReferenceLinkImageData(lineMetadata) {
                 !matchString.startsWith("!\\") &&
                 !matchText.endsWith("\\") &&
                 !(matchLabel || "").endsWith("\\") &&
-                (topLevel || matchString.startsWith("!")) &&
-                !excluded(referenceLinkMatch)) {
+                !(topLevel && excluded(referenceLinkMatch))) {
                 const shortcutLink = (matchLabel === undefined);
                 const collapsedLink = (!shortcutLink && (matchLabel.length === 0));
                 const label = normalizeLabel((shortcutLink || collapsedLink) ? matchText : matchLabel);
                 if (label.length > 0) {
+                    const referenceindex = referenceLinkMatch.index;
+                    if (topLevel) {
+                        // Calculate line index
+                        while (lineOffsets[lineIndex + 1] <= referenceindex) {
+                            lineIndex++;
+                        }
+                    }
+                    else {
+                        // Use provided line index
+                        lineIndex = contentLineIndex;
+                    }
+                    const referenceIndex = referenceindex +
+                        (topLevel ? -lineOffsets[lineIndex] : contentIndex);
                     if (shortcutLink) {
-                        // Track, but don't validate due to ambiguity: "text [text] text"
+                        // Track separately due to ambiguity in "text [text] text"
                         shortcuts.add(label);
                     }
                     else {
-                        const referenceindex = referenceLinkMatch.index;
-                        if (topLevel) {
-                            // Calculate line index
-                            while (lineOffsets[lineIndex + 1] <= referenceindex) {
-                                lineIndex++;
-                            }
-                        }
-                        else {
-                            // Use provided line index
-                            lineIndex = contentLineIndex;
-                        }
-                        const referenceIndex = referenceindex +
-                            (topLevel ? -lineOffsets[lineIndex] : contentIndex);
                         // Track reference and location
                         const referenceData = references.get(label) || [];
                         referenceData.push([
@@ -845,15 +848,15 @@ function getReferenceLinkImageData(lineMetadata) {
                             matchString.length
                         ]);
                         references.set(label, referenceData);
-                        // Check for images embedded in top-level link text
-                        if (!matchString.startsWith("!")) {
-                            pendingContents.push({
-                                "content": matchText,
-                                "contentLineIndex": lineIndex,
-                                "contentIndex": referenceIndex + 1,
-                                "topLevel": false
-                            });
-                        }
+                    }
+                    // Check for links embedded in brackets
+                    if (!matchString.startsWith("!")) {
+                        pendingContents.push({
+                            "content": matchText,
+                            "contentLineIndex": lineIndex,
+                            "contentIndex": referenceIndex + 1,
+                            "topLevel": false
+                        });
                     }
                 }
             }
@@ -1187,7 +1190,7 @@ module.exports.referenceLinkImageData =
 
 module.exports.deprecatedRuleNames = ["MD002", "MD006"];
 module.exports.homepage = "https://github.com/DavidAnson/markdownlint";
-module.exports.version = "0.26.1";
+module.exports.version = "0.26.2";
 
 
 /***/ }),
@@ -1419,11 +1422,6 @@ function annotateAndFreezeTokens(tokens, lines) {
         if (!token.map && trMap) {
             token.map = [...trMap];
         }
-        // Adjust maps for math blocks
-        if (helpers.isMathBlock(token) && token.map[1]) {
-            // markdown-it-texmath plugin does not account for math_block_end
-            token.map[1]++;
-        }
         // Update token metadata
         if (token.map) {
             token.line = lines[token.map[0]];
@@ -3588,9 +3586,8 @@ module.exports = {
 "use strict";
 // @ts-check
 
-const { addErrorContext, isBlankLine } = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js");
+const { addErrorContext, blockquotePrefixRe, isBlankLine } = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js");
 const { flattenedLists } = __webpack_require__(/*! ./cache */ "../lib/cache.js");
-const quotePrefixRe = /^[>\s]*/;
 module.exports = {
     "names": ["MD032", "blanks-around-lists"],
     "description": "Lists should be surrounded by blank lines",
@@ -3602,7 +3599,7 @@ module.exports = {
             const firstIndex = list.open.map[0];
             if (!isBlankLine(lines[firstIndex - 1])) {
                 const line = lines[firstIndex];
-                const quotePrefix = line.match(quotePrefixRe)[0].trimEnd();
+                const quotePrefix = line.match(blockquotePrefixRe)[0].trimEnd();
                 addErrorContext(onError, firstIndex + 1, line.trim(), null, null, null, {
                     "insertText": `${quotePrefix}\n`
                 });
@@ -3610,7 +3607,7 @@ module.exports = {
             const lastIndex = list.lastLineIndex - 1;
             if (!isBlankLine(lines[lastIndex + 1])) {
                 const line = lines[lastIndex];
-                const quotePrefix = line.match(quotePrefixRe)[0].trimEnd();
+                const quotePrefix = line.match(blockquotePrefixRe)[0].trimEnd();
                 addErrorContext(onError, lastIndex + 1, line.trim(), null, null, null, {
                     "lineNumber": lastIndex + 2,
                     "insertText": `${quotePrefix}\n`
@@ -3661,7 +3658,7 @@ module.exports = {
                     if (!linkDestinationRe.test(prefix)) {
                         const unescaped = unescapeMarkdown(prefix + "<", "_");
                         if (!unescaped.endsWith("_")) {
-                            addError(onError, lineIndex + 1, "Element: " + element, null, [match.index + 1, tag.length]);
+                            addError(onError, lineIndex + 1, "Element: " + element, undefined, [match.index + 1, tag.length]);
                         }
                     }
                 }
@@ -3842,8 +3839,8 @@ module.exports = {
 "use strict";
 // @ts-check
 
-const { addErrorContext, emphasisMarkersInContent, forEachLine, isBlankLine } = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js");
-const { lineMetadata } = __webpack_require__(/*! ./cache */ "../lib/cache.js");
+const { addErrorContext, emphasisMarkersInContent, forEachLine, isBlankLine, withinAnyRange } = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js");
+const { htmlElementRanges, lineMetadata } = __webpack_require__(/*! ./cache */ "../lib/cache.js");
 const emphasisRe = /(^|[^\\]|\\\\)(?:(\*\*?\*?)|(__?_?))/g;
 const embeddedUnderscoreRe = /([A-Za-z0-9])_([A-Za-z0-9])/g;
 const asteriskListItemMarkerRe = /^([\s>]*)\*(\s+)/;
@@ -3855,6 +3852,7 @@ module.exports = {
     "description": "Spaces inside emphasis markers",
     "tags": ["whitespace", "emphasis"],
     "function": function MD037(params, onError) {
+        const exclusions = htmlElementRanges();
         // eslint-disable-next-line init-declarations
         let effectiveEmphasisLength, emphasisIndex, emphasisKind, emphasisLength, pendingError = null;
         // eslint-disable-next-line jsdoc/require-jsdoc
@@ -3882,25 +3880,27 @@ module.exports = {
                 // Report the violation
                 const contextStart = emphasisIndex - emphasisLength;
                 const contextEnd = matchIndex + contextLength;
-                const context = line.substring(contextStart, contextEnd);
                 const column = contextStart + 1;
                 const length = contextEnd - contextStart;
-                const leftMarker = line.substring(contextStart, emphasisIndex);
-                const rightMarker = match ? (match[2] || match[3]) : "";
-                const fixedText = `${leftMarker}${content.trim()}${rightMarker}`;
-                return [
-                    onError,
-                    lineIndex + 1,
-                    context,
-                    leftSpace,
-                    rightSpace,
-                    [column, length],
-                    {
-                        "editColumn": column,
-                        "deleteCount": length,
-                        "insertText": fixedText
-                    }
-                ];
+                if (!withinAnyRange(exclusions, lineIndex, column, length)) {
+                    const context = line.substring(contextStart, contextEnd);
+                    const leftMarker = line.substring(contextStart, emphasisIndex);
+                    const rightMarker = match ? (match[2] || match[3]) : "";
+                    const fixedText = `${leftMarker}${content.trim()}${rightMarker}`;
+                    return [
+                        onError,
+                        lineIndex + 1,
+                        context,
+                        leftSpace,
+                        rightSpace,
+                        [column, length],
+                        {
+                            "editColumn": column,
+                            "deleteCount": length,
+                            "insertText": fixedText
+                        }
+                    ];
+                }
             }
             return null;
         }
@@ -4601,7 +4601,8 @@ module.exports = [
 
 const { addError, escapeForRegExp, filterTokens, forEachInlineChild, forEachHeading, htmlElementRe } = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js");
 // Regular expression for identifying HTML anchor names
-const identifierRe = /(?:id|name)\s*=\s*['"]?([^'"\s>]+)/iu;
+const idRe = /\sid\s*=\s*['"]?([^'"\s>]+)/iu;
+const nameRe = /\sname\s*=\s*['"]?([^'"\s>]+)/iu;
 /**
  * Converts a Markdown heading into an HTML fragment according to the rules
  * used by GitHub.
@@ -4643,11 +4644,10 @@ module.exports = {
             let match = null;
             while ((match = htmlElementRe.exec(token.content)) !== null) {
                 const [tag, , element] = match;
-                if (element.toLowerCase() === "a") {
-                    const idMatch = identifierRe.exec(tag);
-                    if (idMatch) {
-                        fragments.set(`#${idMatch[1]}`, 0);
-                    }
+                const anchorMatch = idRe.exec(tag) ||
+                    (element.toLowerCase() === "a" && nameRe.exec(tag));
+                if (anchorMatch) {
+                    fragments.set(`#${anchorMatch[1]}`, 0);
                 }
             }
         };
@@ -4727,7 +4727,8 @@ module.exports = {
     "description": "Link and image reference definitions should be needed",
     "tags": ["images", "links"],
     "function": function MD053(params, onError) {
-        const { lines } = params;
+        const ignored = new Set(params.config.ignored_definitions || ["//"]);
+        const lines = params.lines;
         const { references, shortcuts, definitions, duplicateDefinitions } = referenceLinkImageData();
         const singleLineDefinition = (line) => (line.replace(linkReferenceDefinitionRe, "").trim().length > 0);
         const deleteFixInfo = {
@@ -4736,7 +4737,9 @@ module.exports = {
         // Look for unused link references (unreferenced by any link/image)
         for (const definition of definitions.entries()) {
             const [label, lineIndex] = definition;
-            if (!references.has(label) && !shortcuts.has(label)) {
+            if (!ignored.has(label) &&
+                !references.has(label) &&
+                !shortcuts.has(label)) {
                 const line = lines[lineIndex];
                 addError(onError, lineIndex + 1, `Unused link or image reference definition: "${label}"`, ellipsify(line), [1, line.length], singleLineDefinition(line) ? deleteFixInfo : 0);
             }
@@ -4744,8 +4747,10 @@ module.exports = {
         // Look for duplicate link references (defined more than once)
         for (const duplicateDefinition of duplicateDefinitions) {
             const [label, lineIndex] = duplicateDefinition;
-            const line = lines[lineIndex];
-            addError(onError, lineIndex + 1, `Duplicate link or image reference definition: "${label}"`, ellipsify(line), [1, line.length], singleLineDefinition(line) ? deleteFixInfo : 0);
+            if (!ignored.has(label)) {
+                const line = lines[lineIndex];
+                addError(onError, lineIndex + 1, `Duplicate link or image reference definition: "${label}"`, ellipsify(line), [1, line.length], singleLineDefinition(line) ? deleteFixInfo : 0);
+            }
         }
     }
 };

package/doc/Rules.md

@@ -1315,7 +1315,7 @@ To fix this, use 'pure' Markdown instead of including raw HTML:
 # Markdown heading
 ```
 
-Note: To allow specific HTML elements, use the 'allowed_elements' parameter.
+Note: To allow specific HTML elements, use the `allowed_elements` parameter.
 
 Rationale: Raw HTML is allowed in Markdown, but this rule is included for
 those who want their documents to only include "pure" Markdown, or for those
@@ -2075,6 +2075,8 @@ Tags: images, links
 
 Aliases: link-image-reference-definitions
 
+Parameters: ignored_definitions (array of string; default [ "//" ])
+
 Fixable: Most violations can be fixed by tooling
 
 Links and images in Markdown can provide the link destination or image source
@@ -2092,9 +2094,18 @@ unnecessary:
    used and the others can be deleted.
 
 This rule considers a reference definition to be used if any link or image
-reference has the corresponding label. "Full", "collapsed", and "shortcut"
+reference has the corresponding label. The "full", "collapsed", and "shortcut"
 formats are all supported.
 
+If there are reference definitions that are deliberately unreferenced, they can
+be ignored by setting the `ignored_definitions` parameter. The default value of
+this parameter ignores the following convention for adding non-HTML comments to
+Markdown:
+
+```md
+[//]: # (This behaves like a comment)
+```
+
 <!-- markdownlint-configure-file {
   "no-inline-html": {
     "allowed_elements": [

package/helpers/helpers.js

@@ -30,9 +30,13 @@ module.exports.orderedListItemMarkerRe = /^[\s>]*0*(\d+)[.)]/;
 // Regular expression for all instances of emphasis markers
 const emphasisMarkersRe = /[_*]/g;
 
-// Regular expression for reference links (full and collapsed but not shortcut)
+// Regular expression for blockquote prefixes
+const blockquotePrefixRe = /^[>\s]*/;
+module.exports.blockquotePrefixRe = blockquotePrefixRe;
+
+// Regular expression for reference links (full, collapsed, and shortcut)
 const referenceLinkRe =
-  /!?\\?\[((?:\[[^\]\0]*]|[^\]\0])*)](?:(?:\[([^\]\0]*)\])|[^(]|$)/g;
+  /!?\\?\[((?:\[[^\]\0]*]|[^\]\0])*)](?:(?:\[([^\]\0]*)\])|([^(])|$)/g;
 
 // Regular expression for link reference definitions
 const linkReferenceDefinitionRe = /^ {0,3}\[([^\]]*[^\\])]:/;
@@ -785,7 +789,7 @@ function getReferenceLinkImageData(lineMetadata) {
   const normalizeLabel = (s) => s.toLowerCase().trim().replace(/\s+/g, " ");
   const exclusions = [];
   const excluded = (match) => withinAnyRange(
-    exclusions, 0, match.index, match[0].length
+    exclusions, 0, match.index, match[0].length - (match[3] || "").length
   );
   // Convert input to single-line so multi-line links/images are easier
   const lineOffsets = [];
@@ -794,6 +798,7 @@ function getReferenceLinkImageData(lineMetadata) {
   forEachLine(lineMetadata, (line, lineIndex, inCode) => {
     lineOffsets[lineIndex] = currentOffset;
     if (!inCode) {
+      line = line.replace(blockquotePrefixRe, "");
       if (line.trim().length === 0) {
         // Allow RegExp to detect the end of a block
         line = "\0";
@@ -845,8 +850,7 @@ function getReferenceLinkImageData(lineMetadata) {
         !matchString.startsWith("!\\") &&
         !matchText.endsWith("\\") &&
         !(matchLabel || "").endsWith("\\") &&
-        (topLevel || matchString.startsWith("!")) &&
-        !excluded(referenceLinkMatch)
+        !(topLevel && excluded(referenceLinkMatch))
       ) {
         const shortcutLink = (matchLabel === undefined);
         const collapsedLink =
@@ -855,22 +859,22 @@ function getReferenceLinkImageData(lineMetadata) {
           (shortcutLink || collapsedLink) ? matchText : matchLabel
         );
         if (label.length > 0) {
+          const referenceindex = referenceLinkMatch.index;
+          if (topLevel) {
+            // Calculate line index
+            while (lineOffsets[lineIndex + 1] <= referenceindex) {
+              lineIndex++;
+            }
+          } else {
+            // Use provided line index
+            lineIndex = contentLineIndex;
+          }
+          const referenceIndex = referenceindex +
+            (topLevel ? -lineOffsets[lineIndex] : contentIndex);
           if (shortcutLink) {
-            // Track, but don't validate due to ambiguity: "text [text] text"
+            // Track separately due to ambiguity in "text [text] text"
             shortcuts.add(label);
           } else {
-            const referenceindex = referenceLinkMatch.index;
-            if (topLevel) {
-              // Calculate line index
-              while (lineOffsets[lineIndex + 1] <= referenceindex) {
-                lineIndex++;
-              }
-            } else {
-              // Use provided line index
-              lineIndex = contentLineIndex;
-            }
-            const referenceIndex = referenceindex +
-              (topLevel ? -lineOffsets[lineIndex] : contentIndex);
             // Track reference and location
             const referenceData = references.get(label) || [];
             referenceData.push([
@@ -879,17 +883,15 @@ function getReferenceLinkImageData(lineMetadata) {
               matchString.length
             ]);
             references.set(label, referenceData);
-            // Check for images embedded in top-level link text
-            if (!matchString.startsWith("!")) {
-              pendingContents.push(
-                {
-                  "content": matchText,
-                  "contentLineIndex": lineIndex,
-                  "contentIndex": referenceIndex + 1,
-                  "topLevel": false
-                }
-              );
-            }
+          }
+          // Check for links embedded in brackets
+          if (!matchString.startsWith("!")) {
+            pendingContents.push({
+              "content": matchText,
+              "contentLineIndex": lineIndex,
+              "contentIndex": referenceIndex + 1,
+              "topLevel": false
+            });
           }
         }
       }

package/helpers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdownlint-rule-helpers",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "A collection of markdownlint helper functions for custom rules",
   "main": "./helpers.js",
   "exports": "./helpers.js",

package/lib/constants.js

@@ -4,4 +4,4 @@
 
 module.exports.deprecatedRuleNames = [ "MD002", "MD006" ];
 module.exports.homepage = "https://github.com/DavidAnson/markdownlint";
-module.exports.version = "0.26.1";
+module.exports.version = "0.26.2";

package/lib/markdownlint.js

@@ -233,11 +233,6 @@ function annotateAndFreezeTokens(tokens, lines) {
     if (!token.map && trMap) {
       token.map = [ ...trMap ];
     }
-    // Adjust maps for math blocks
-    if (helpers.isMathBlock(token) && token.map[1]) {
-      // markdown-it-texmath plugin does not account for math_block_end
-      token.map[1]++;
-    }
     // Update token metadata
     if (token.map) {
       token.line = lines[token.map[0]];

package/lib/md032.js

@@ -2,11 +2,10 @@
 
 "use strict";
 
-const { addErrorContext, isBlankLine } = require("../helpers");
+const { addErrorContext, blockquotePrefixRe, isBlankLine } =
+  require("../helpers");
 const { flattenedLists } = require("./cache");
 
-const quotePrefixRe = /^[>\s]*/;
-
 module.exports = {
   "names": [ "MD032", "blanks-around-lists" ],
   "description": "Lists should be surrounded by blank lines",
@@ -18,7 +17,7 @@ module.exports = {
       const firstIndex = list.open.map[0];
       if (!isBlankLine(lines[firstIndex - 1])) {
         const line = lines[firstIndex];
-        const quotePrefix = line.match(quotePrefixRe)[0].trimEnd();
+        const quotePrefix = line.match(blockquotePrefixRe)[0].trimEnd();
         addErrorContext(
           onError,
           firstIndex + 1,
@@ -33,7 +32,7 @@ module.exports = {
       const lastIndex = list.lastLineIndex - 1;
       if (!isBlankLine(lines[lastIndex + 1])) {
         const line = lines[lastIndex];
-        const quotePrefix = line.match(quotePrefixRe)[0].trimEnd();
+        const quotePrefix = line.match(blockquotePrefixRe)[0].trimEnd();
         addErrorContext(
           onError,
           lastIndex + 1,

package/lib/md033.js

@@ -38,7 +38,7 @@ module.exports = {
             const unescaped = unescapeMarkdown(prefix + "<", "_");
             if (!unescaped.endsWith("_")) {
               addError(onError, lineIndex + 1, "Element: " + element,
-                null, [ match.index + 1, tag.length ]);
+                undefined, [ match.index + 1, tag.length ]);
             }
           }
         }

package/lib/md037.js

@@ -2,9 +2,9 @@
 
 "use strict";
 
-const { addErrorContext, emphasisMarkersInContent, forEachLine, isBlankLine } =
-  require("../helpers");
-const { lineMetadata } = require("./cache");
+const { addErrorContext, emphasisMarkersInContent, forEachLine, isBlankLine,
+  withinAnyRange } = require("../helpers");
+const { htmlElementRanges, lineMetadata } = require("./cache");
 
 const emphasisRe = /(^|[^\\]|\\\\)(?:(\*\*?\*?)|(__?_?))/g;
 const embeddedUnderscoreRe = /([A-Za-z0-9])_([A-Za-z0-9])/g;
@@ -18,6 +18,7 @@ module.exports = {
   "description": "Spaces inside emphasis markers",
   "tags": [ "whitespace", "emphasis" ],
   "function": function MD037(params, onError) {
+    const exclusions = htmlElementRanges();
     // eslint-disable-next-line init-declarations
     let effectiveEmphasisLength, emphasisIndex, emphasisKind, emphasisLength,
       pendingError = null;
@@ -50,25 +51,27 @@ module.exports = {
         // Report the violation
         const contextStart = emphasisIndex - emphasisLength;
         const contextEnd = matchIndex + contextLength;
-        const context = line.substring(contextStart, contextEnd);
         const column = contextStart + 1;
         const length = contextEnd - contextStart;
-        const leftMarker = line.substring(contextStart, emphasisIndex);
-        const rightMarker = match ? (match[2] || match[3]) : "";
-        const fixedText = `${leftMarker}${content.trim()}${rightMarker}`;
-        return [
-          onError,
-          lineIndex + 1,
-          context,
-          leftSpace,
-          rightSpace,
-          [ column, length ],
-          {
-            "editColumn": column,
-            "deleteCount": length,
-            "insertText": fixedText
-          }
-        ];
+        if (!withinAnyRange(exclusions, lineIndex, column, length)) {
+          const context = line.substring(contextStart, contextEnd);
+          const leftMarker = line.substring(contextStart, emphasisIndex);
+          const rightMarker = match ? (match[2] || match[3]) : "";
+          const fixedText = `${leftMarker}${content.trim()}${rightMarker}`;
+          return [
+            onError,
+            lineIndex + 1,
+            context,
+            leftSpace,
+            rightSpace,
+            [ column, length ],
+            {
+              "editColumn": column,
+              "deleteCount": length,
+              "insertText": fixedText
+            }
+          ];
+        }
       }
       return null;
     }

package/lib/md051.js

@@ -6,7 +6,8 @@ const { addError, escapeForRegExp, filterTokens, forEachInlineChild,
   forEachHeading, htmlElementRe } = require("../helpers");
 
 // Regular expression for identifying HTML anchor names
-const identifierRe = /(?:id|name)\s*=\s*['"]?([^'"\s>]+)/iu;
+const idRe = /\sid\s*=\s*['"]?([^'"\s>]+)/iu;
+const nameRe = /\sname\s*=\s*['"]?([^'"\s>]+)/iu;
 
 /**
  * Converts a Markdown heading into an HTML fragment according to the rules
@@ -55,11 +56,10 @@ module.exports = {
       let match = null;
       while ((match = htmlElementRe.exec(token.content)) !== null) {
         const [ tag, , element ] = match;
-        if (element.toLowerCase() === "a") {
-          const idMatch = identifierRe.exec(tag);
-          if (idMatch) {
-            fragments.set(`#${idMatch[1]}`, 0);
-          }
+        const anchorMatch = idRe.exec(tag) ||
+            (element.toLowerCase() === "a" && nameRe.exec(tag));
+        if (anchorMatch) {
+          fragments.set(`#${anchorMatch[1]}`, 0);
         }
       }
     };

package/lib/md053.js

@@ -11,7 +11,8 @@ module.exports = {
   "description": "Link and image reference definitions should be needed",
   "tags": [ "images", "links" ],
   "function": function MD053(params, onError) {
-    const { lines } = params;
+    const ignored = new Set(params.config.ignored_definitions || [ "//" ]);
+    const lines = params.lines;
     const { references, shortcuts, definitions, duplicateDefinitions } =
       referenceLinkImageData();
     const singleLineDefinition = (line) => (
@@ -23,7 +24,11 @@ module.exports = {
     // Look for unused link references (unreferenced by any link/image)
     for (const definition of definitions.entries()) {
       const [ label, lineIndex ] = definition;
-      if (!references.has(label) && !shortcuts.has(label)) {
+      if (
+        !ignored.has(label) &&
+        !references.has(label) &&
+        !shortcuts.has(label)
+      ) {
         const line = lines[lineIndex];
         addError(
           onError,
@@ -38,15 +43,17 @@ module.exports = {
     // Look for duplicate link references (defined more than once)
     for (const duplicateDefinition of duplicateDefinitions) {
       const [ label, lineIndex ] = duplicateDefinition;
-      const line = lines[lineIndex];
-      addError(
-        onError,
-        lineIndex + 1,
-        `Duplicate link or image reference definition: "${label}"`,
-        ellipsify(line),
-        [ 1, line.length ],
-        singleLineDefinition(line) ? deleteFixInfo : 0
-      );
+      if (!ignored.has(label)) {
+        const line = lines[lineIndex];
+        addError(
+          onError,
+          lineIndex + 1,
+          `Duplicate link or image reference definition: "${label}"`,
+          ellipsify(line),
+          [ 1, line.length ],
+          singleLineDefinition(line) ? deleteFixInfo : 0
+        );
+      }
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdownlint",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "description": "A Node.js style checker and lint tool for Markdown/CommonMark files.",
   "type": "commonjs",
   "main": "./lib/markdownlint.js",

package/schema/.markdownlint.jsonc

@@ -275,5 +275,10 @@
   "MD052": true,
 
   // MD053/link-image-reference-definitions - Link and image reference definitions should be needed
-  "MD053": true
+  "MD053": {
+    // Ignored definitions
+    "ignored_definitions": [
+      "//"
+    ]
+  }
 }

package/schema/.markdownlint.yaml

@@ -249,4 +249,8 @@ MD051: true
 MD052: true
 
 # MD053/link-image-reference-definitions - Link and image reference definitions should be needed
-MD053: true
+MD053:
+  # Ignored definitions
+  ignored_definitions: [
+    "//"
+  ]

package/schema/markdownlint-config-schema.json

@@ -909,8 +909,24 @@
     },
     "MD053": {
       "description": "MD053/link-image-reference-definitions - Link and image reference definitions should be needed",
-      "type": "boolean",
-      "default": true
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "ignored_definitions": {
+          "description": "Ignored definitions",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [
+            "//"
+          ]
+        }
+      },
+      "additionalProperties": false
     },
     "link-image-reference-definitions": {
       "$ref": "#/properties/MD053"