markdownlint 0.28.2 → 0.29.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.29.0
+
+- Update `micromark` parser dependencies for better performance
+- Use `micromark` in MD049/MD050
+- Improve MD034/MD037/MD044/MD049/MD050
+- Support multiple parsers in demo page
+- Remove support for end-of-life Node version 14
+- Update dependencies
+
 ## 0.28.2
 
 - Update dependencies for CVE-2023-2251
@@ -13,7 +22,7 @@
 - Introduce `micromark` parser for better positional data (internal only)
 - Use `micromark` in MD013/MD033/MD034/MD035/MD038/MD044/MD052/MD053
 - Simplify file-based test cases
-- Unify browser script for demo
+- Unify browser script for demo page
 - Update dependencies
 
 ## 0.27.0

package/CONTRIBUTING.md

@@ -17,6 +17,11 @@ Do not add new [`dependencies` to `package.json`][dependencies]. The Markdown
 parsers [`markdown-it`][markdown-it] and [`micromark`][micromark] are the
 project's only dependencies.
 
+Package versions for `dependencies` and `devDependencies` should be specified
+exactly (also known as "pinning"). The short explanation is that doing otherwise
+eventually leads to inconsistent behavior and broken functionality. (See [Pin
+your npm/yarn dependencies][pin-dependencies] for a longer explanation.)
+
 If developing a new rule, start by creating a [custom rule][custom-rules] in its
 own project. Once written, published, and tested in real world scenarios, open
 an issue to consider adding it to this project. For rule ideas, see [issues
@@ -83,4 +88,5 @@ Thank you!
 [micromark]: https://www.npmjs.com/package/micromark
 [new-rule]: https://github.com/DavidAnson/markdownlint/labels/new%20rule
 [npm-scripts]: https://docs.npmjs.com/misc/scripts
+[pin-dependencies]: https://maxleiter.com/blog/pin-dependencies
 [rewriting-history]: https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History

package/README.md

@@ -70,6 +70,13 @@ and test cases came directly from that project.
 [super-linter]: https://github.com/github/super-linter
 [vscode-markdownlint]: https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint
 
+### References
+
+The following specifications are considered authoritative in cases of ambiguity:
+
+- [CommonMark](https://spec.commonmark.org/current/)
+- [GitHub Flavored Markdown Spec](https://github.github.com/gfm/)
+
 ## Demonstration
 
 [`markdownlint` demo](https://dlaa.me/markdownlint/), an interactive, in-browser
@@ -185,7 +192,7 @@ rules at once.
 ## Configuration
 
 Text passed to `markdownlint` is parsed as Markdown, analyzed, and any
-issues reported. Two kinds of text are ignored:
+issues reported. Two kinds of text are ignored by most rules:
 
 - [HTML comments](https://www.w3.org/TR/html5/syntax.html#comments)
 - [Front matter](https://jekyllrb.com/docs/frontmatter/) (see

package/demo/markdownlint-browser.js

@@ -1,4 +1,4 @@
-/*! markdownlint 0.28.2 https://github.com/DavidAnson/markdownlint @license MIT */
+/*! markdownlint 0.29.0 https://github.com/DavidAnson/markdownlint @license MIT */
 var markdownlint;
 /******/ (() => { // webpackBootstrap
 /******/ 	var __webpack_modules__ = ({
@@ -1165,61 +1165,6 @@ function applyFixes(input, errors) {
 }
 module.exports.applyFixes = applyFixes;
 
-/**
- * Gets the range and fixInfo values for reporting an error if the expected
- * text is found on the specified line.
- *
- * @param {string[]} lines Lines of Markdown content.
- * @param {number} lineIndex Line index to check.
- * @param {string} search Text to search for.
- * @param {string} replace Text to replace with.
- * @param {number} [instance] Instance on the line (1-based).
- * @returns {Object} Range and fixInfo wrapper.
- */
-module.exports.getRangeAndFixInfoIfFound = function (lines, lineIndex, search, replace) {
-  var instance = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : 1;
-  var range = null;
-  var fixInfo = null;
-  var searchIndex = -1;
-  while (instance > 0) {
-    searchIndex = lines[lineIndex].indexOf(search, searchIndex + 1);
-    instance--;
-  }
-  if (searchIndex !== -1) {
-    var column = searchIndex + 1;
-    var length = search.length;
-    range = [column, length];
-    fixInfo = {
-      "editColumn": column,
-      "deleteCount": length,
-      "insertText": replace
-    };
-  }
-  return {
-    range: range,
-    fixInfo: fixInfo
-  };
-};
-
-/**
- * Gets the next (subsequent) child token if it is of the expected type.
- *
- * @param {Object} parentToken Parent token.
- * @param {Object} childToken Child token basis.
- * @param {string} nextType Token type of next token.
- * @param {string} nextNextType Token type of next-next token.
- * @returns {Object} Next token.
- */
-function getNextChildToken(parentToken, childToken, nextType, nextNextType) {
-  var children = parentToken.children;
-  var index = children.indexOf(childToken);
-  if (index !== -1 && children.length > index + 2 && children[index + 1].type === nextType && children[index + 2].type === nextNextType) {
-    return children[index + 1];
-  }
-  return null;
-}
-module.exports.getNextChildToken = getNextChildToken;
-
 /**
  * Expands a path with a tilde to an absolute path.
  *
@@ -1374,10 +1319,12 @@ var _require = __webpack_require__(/*! markdownlint-micromark */ "markdownlint-m
  *
  * @param {string} markdown Markdown document.
  * @param {Object} [options] Options for micromark.
+ * @param {boolean} [refsDefined] Whether to treat references as defined.
  * @returns {Object[]} Micromark events.
  */
 function getMicromarkEvents(markdown) {
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var refsDefined = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
   // Customize options object to add useful extensions
   options.extensions = options.extensions || [];
   options.extensions.push(gfmAutolinkLiteral, gfmFootnote(), gfmTable);
@@ -1386,10 +1333,12 @@ function getMicromarkEvents(markdown) {
   var encoding = undefined;
   var eol = true;
   var parseContext = parse(options);
-  // Customize ParseContext to treat all references as defined
-  parseContext.defined.includes = function (searchElement) {
-    return searchElement.length > 0;
-  };
+  if (refsDefined) {
+    // Customize ParseContext to treat all references as defined
+    parseContext.defined.includes = function (searchElement) {
+      return searchElement.length > 0;
+    };
+  }
   var chunks = preprocess()(markdown, encoding, eol);
   var events = postprocess(parseContext.document().write(chunks));
   return events;
@@ -1400,12 +1349,14 @@ function getMicromarkEvents(markdown) {
  *
  * @param {string} markdown Markdown document.
  * @param {Object} [options] Options for micromark.
+ * @param {boolean} [refsDefined] Whether to treat references as defined.
  * @returns {Token[]} Micromark tokens (frozen).
  */
 function micromarkParse(markdown) {
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var refsDefined = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
   // Use micromark to parse document into Events
-  var events = getMicromarkEvents(markdown, options);
+  var events = getMicromarkEvents(markdown, options, refsDefined);
 
   // Create Token objects
   var document = [];
@@ -1429,12 +1380,7 @@ function micromarkParse(markdown) {
         startLine = start["line"];
       var endColumn = end["column"],
         endLine = end["line"];
-      var text = null;
-      try {
-        text = context.sliceSerialize(token);
-      } catch (_unused) {
-        // https://github.com/micromark/micromark/issues/131
-      }
+      var text = context.sliceSerialize(token);
       if (kind === "enter") {
         var previous = current;
         history.push(previous);
@@ -1466,6 +1412,25 @@ function micromarkParse(markdown) {
   return document;
 }
 
+// /**
+//  * Log the structure of a Micromark token list.
+//  *
+//  * @param {Token[]} tokens Micromark tokens.
+//  * @param {number} depth Tree depth.
+//  * @returns {void}
+//  */
+// function consoleLogTokens(tokens, depth = 0) {
+//   for (const token of tokens) {
+//     const { children, text, type } = token;
+//     console.log(
+//       `${" ".repeat(depth * 2)}${type} ${text.replace(/\n/g, "\\n")}`
+//     );
+//     if (children.length > 0) {
+//       consoleLogTokens(children, depth + 1);
+//     }
+//   }
+// }
+
 /**
  * Filter a list of Micromark tokens by predicate.
  *
@@ -1563,6 +1528,17 @@ function matchAndGetTokensByType(tokens, matchTypes, resultTypes) {
   }
   return result;
 }
+
+/**
+ * Returns the specified token iff it is of the desired type.
+ *
+ * @param {Token} token Micromark token candidate.
+ * @param {string} type Desired type.
+ * @returns {Token | null} Token instance.
+ */
+function tokenIfType(token, type) {
+  return token && token.type === type ? token : null;
+}
 module.exports = {
   "parse": micromarkParse,
   filterByPredicate: filterByPredicate,
@@ -1570,7 +1546,8 @@ module.exports = {
   getHtmlTagInfo: getHtmlTagInfo,
   getMicromarkEvents: getMicromarkEvents,
   getTokenTextByType: getTokenTextByType,
-  matchAndGetTokensByType: matchAndGetTokensByType
+  matchAndGetTokensByType: matchAndGetTokensByType,
+  tokenIfType: tokenIfType
 };
 
 /***/ }),
@@ -1636,7 +1613,7 @@ module.exports.referenceLinkImageData = function () {
 module.exports.deprecatedRuleNames = ["MD002", "MD006"];
 module.exports.fixableRuleNames = ["MD004", "MD005", "MD006", "MD007", "MD009", "MD010", "MD011", "MD012", "MD014", "MD018", "MD019", "MD020", "MD021", "MD022", "MD023", "MD026", "MD027", "MD030", "MD031", "MD032", "MD034", "MD037", "MD038", "MD039", "MD044", "MD047", "MD049", "MD050", "MD051", "MD053"];
 module.exports.homepage = "https://github.com/DavidAnson/markdownlint";
-module.exports.version = "0.28.2";
+module.exports.version = "0.29.0";
 
 /***/ }),
 
@@ -5008,60 +4985,68 @@ var _require = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js"),
   addErrorContext = _require.addErrorContext;
 var _require2 = __webpack_require__(/*! ../helpers/micromark.cjs */ "../helpers/micromark.cjs"),
   filterByPredicate = _require2.filterByPredicate,
-  getHtmlTagInfo = _require2.getHtmlTagInfo;
+  getHtmlTagInfo = _require2.getHtmlTagInfo,
+  parse = _require2.parse;
 module.exports = {
   "names": ["MD034", "no-bare-urls"],
   "description": "Bare URL used",
   "tags": ["links", "url"],
   "function": function MD034(params, onError) {
-    var literalAutolinks = filterByPredicate(params.parsers.micromark.tokens, function (token) {
-      return token.type === "literalAutolink";
-    }, function (token) {
-      var children = token.children;
-      var result = [];
-      for (var i = 0; i < children.length; i++) {
-        var openToken = children[i];
-        var openTagInfo = getHtmlTagInfo(openToken);
-        if (openTagInfo && !openTagInfo.close) {
-          var count = 1;
-          for (var j = i + 1; j < children.length; j++) {
-            var closeToken = children[j];
-            var closeTagInfo = getHtmlTagInfo(closeToken);
-            if (closeTagInfo && openTagInfo.name === closeTagInfo.name) {
-              if (closeTagInfo.close) {
-                count--;
-                if (count === 0) {
-                  i = j;
-                  break;
+    var literalAutolinks = function literalAutolinks(tokens) {
+      return filterByPredicate(tokens, function (token) {
+        return token.type === "literalAutolink";
+      }, function (token) {
+        var children = token.children;
+        var result = [];
+        for (var i = 0; i < children.length; i++) {
+          var openToken = children[i];
+          var openTagInfo = getHtmlTagInfo(openToken);
+          if (openTagInfo && !openTagInfo.close) {
+            var count = 1;
+            for (var j = i + 1; j < children.length; j++) {
+              var closeToken = children[j];
+              var closeTagInfo = getHtmlTagInfo(closeToken);
+              if (closeTagInfo && openTagInfo.name === closeTagInfo.name) {
+                if (closeTagInfo.close) {
+                  count--;
+                  if (count === 0) {
+                    i = j;
+                    break;
+                  }
+                } else {
+                  count++;
                 }
-              } else {
-                count++;
               }
             }
+          } else {
+            result.push(openToken);
           }
-        } else {
-          result.push(openToken);
         }
+        return result;
+      });
+    };
+    if (literalAutolinks(params.parsers.micromark.tokens).length > 0) {
+      // Re-parse with correct link/image reference definition handling
+      var document = params.lines.join("\n");
+      var tokens = parse(document, undefined, false);
+      var _iterator = _createForOfIteratorHelper(literalAutolinks(tokens)),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var token = _step.value;
+          var range = [token.startColumn, token.endColumn - token.startColumn];
+          var fixInfo = {
+            "editColumn": range[0],
+            "deleteCount": range[1],
+            "insertText": "<".concat(token.text, ">")
+          };
+          addErrorContext(onError, token.startLine, token.text, null, null, range, fixInfo);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
       }
-      return result;
-    });
-    var _iterator = _createForOfIteratorHelper(literalAutolinks),
-      _step;
-    try {
-      for (_iterator.s(); !(_step = _iterator.n()).done;) {
-        var token = _step.value;
-        var range = [token.startColumn, token.endColumn - token.startColumn];
-        var fixInfo = {
-          "editColumn": range[0],
-          "deleteCount": range[1],
-          "insertText": "<".concat(token.text, ">")
-        };
-        addErrorContext(onError, token.startLine, token.text, null, null, range, fixInfo);
-      }
-    } catch (err) {
-      _iterator.e(err);
-    } finally {
-      _iterator.f();
     }
   }
 };
@@ -5215,11 +5200,12 @@ var _require2 = __webpack_require__(/*! ./cache */ "../lib/cache.js"),
   htmlElementRanges = _require2.htmlElementRanges,
   lineMetadata = _require2.lineMetadata;
 var emphasisRe = /(^|[^\\]|\\\\)(?:(\*{1,3})|(_{1,3}))/g;
-var embeddedUnderscoreRe = /([A-Za-z\d])_([A-Za-z\d])/g;
+var embeddedUnderscoreRe = /([A-Za-z\d])(_([A-Za-z\d]))+/g;
 var asteriskListItemMarkerRe = /^([\s>]*)\*(\s+)/;
 var leftSpaceRe = /^\s+/;
 var rightSpaceRe = /\s+$/;
 var tablePipeRe = /\|/;
+var allUnderscoresRe = /_/g;
 module.exports = {
   "names": ["MD037", "no-space-in-emphasis"],
   "description": "Spaces inside emphasis markers",
@@ -5285,7 +5271,9 @@ module.exports = {
         // Emphasis has no meaning here
         return;
       }
-      var patchedLine = line.replace(embeddedUnderscoreRe, "$1 $2");
+      var patchedLine = line.replace(embeddedUnderscoreRe, function (match) {
+        return match.replace(allUnderscoresRe, " ");
+      });
       if (onItemStart) {
         // Trim overlapping '*' list item marker
         patchedLine = patchedLine.replace(asteriskListItemMarkerRe, "$1 $2");
@@ -5373,7 +5361,8 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 var _require = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js"),
   addErrorContext = _require.addErrorContext;
 var _require2 = __webpack_require__(/*! ../helpers/micromark.cjs */ "../helpers/micromark.cjs"),
-  filterByTypes = _require2.filterByTypes;
+  filterByTypes = _require2.filterByTypes,
+  tokenIfType = _require2.tokenIfType;
 var leftSpaceRe = /^\s(?:[^`]|$)/;
 var rightSpaceRe = /[^`]\s$/;
 var trimCodeText = function trimCodeText(text, start, end) {
@@ -5386,9 +5375,6 @@ var trimCodeText = function trimCodeText(text, start, end) {
   }
   return text;
 };
-var tokenIfType = function tokenIfType(token, type) {
-  return token && token.type === type && token;
-};
 module.exports = {
   "names": ["MD038", "no-space-in-code"],
   "description": "Spaces inside code span elements",
@@ -5781,20 +5767,21 @@ module.exports = {
 
 
 
-function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 var _require = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js"),
   addErrorDetailIf = _require.addErrorDetailIf,
   escapeForRegExp = _require.escapeForRegExp,
+  newLineRe = _require.newLineRe,
   withinAnyRange = _require.withinAnyRange;
 var _require2 = __webpack_require__(/*! ../helpers/micromark.cjs */ "../helpers/micromark.cjs"),
   filterByPredicate = _require2.filterByPredicate,
@@ -5820,12 +5807,39 @@ module.exports = {
       scannedTypes.add("codeFlowValue");
       scannedTypes.add("codeTextData");
     }
+    var tokenAdjustments = new Map();
     var contentTokens = filterByPredicate(params.parsers.micromark.tokens, function (token) {
       return scannedTypes.has(token.type);
     }, function (token) {
       var children = token.children;
+      var startLine = token.startLine,
+        text = token.text;
       if (!includeHtmlElements && token.type === "htmlFlow") {
-        children = children.slice(1, -1);
+        if (text.startsWith("<!--")) {
+          // Remove comment content
+          children = [];
+        } else {
+          // Re-parse to get htmlText elements for detailed tokenization
+          var htmlTextLines = "<md044>\n".concat(text, "\n</md044>").split(newLineRe);
+          children = parse(htmlTextLines.join(""));
+          var reTokens = _toConsumableArray(children);
+          var _iterator = _createForOfIteratorHelper(reTokens),
+            _step;
+          try {
+            for (_iterator.s(); !(_step = _iterator.n()).done;) {
+              var reToken = _step.value;
+              tokenAdjustments.set(reToken, {
+                htmlTextLines: htmlTextLines,
+                startLine: startLine
+              });
+              reTokens.push.apply(reTokens, _toConsumableArray(reToken.children));
+            }
+          } catch (err) {
+            _iterator.e(err);
+          } finally {
+            _iterator.f();
+          }
+        }
       }
       return children.filter(function (t) {
         return !ignoredChildTypes.has(t.type);
@@ -5833,21 +5847,21 @@ module.exports = {
     });
     var exclusions = [];
     var autoLinked = new Set();
-    var _iterator = _createForOfIteratorHelper(names),
-      _step;
+    var _iterator2 = _createForOfIteratorHelper(names),
+      _step2;
     try {
-      for (_iterator.s(); !(_step = _iterator.n()).done;) {
-        var name = _step.value;
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var name = _step2.value;
         var escapedName = escapeForRegExp(name);
         var startNamePattern = /^\W/.test(name) ? "" : "\\b_*";
         var endNamePattern = /\W$/.test(name) ? "" : "_*\\b";
         var namePattern = "(".concat(startNamePattern, ")(").concat(escapedName, ")").concat(endNamePattern);
         var nameRe = new RegExp(namePattern, "gi");
-        var _iterator2 = _createForOfIteratorHelper(contentTokens),
-          _step2;
+        var _iterator3 = _createForOfIteratorHelper(contentTokens),
+          _step3;
         try {
           var _loop = function _loop() {
-            var token = _step2.value;
+            var token = _step3.value;
             var match = null;
             var _loop2 = function _loop2() {
               var _match = match,
@@ -5867,8 +5881,21 @@ module.exports = {
                   autoLinked.add(token);
                 }
                 if (!withinAnyRange(urlRanges, lineIndex, index, length)) {
-                  var column = index + 1;
-                  addErrorDetailIf(onError, token.startLine, name, nameMatch, null, null, [column, length], {
+                  var lineNumber = token.startLine;
+                  var column = index;
+                  if (tokenAdjustments.has(token)) {
+                    var _tokenAdjustments$get = tokenAdjustments.get(token),
+                      htmlTextLines = _tokenAdjustments$get.htmlTextLines,
+                      startLine = _tokenAdjustments$get.startLine;
+                    var lineDelta = 0;
+                    while (htmlTextLines[lineDelta].length <= column) {
+                      column -= htmlTextLines[lineDelta].length;
+                      lineDelta++;
+                    }
+                    lineNumber = startLine + lineDelta - 1;
+                  }
+                  column++;
+                  addErrorDetailIf(onError, lineNumber, name, nameMatch, null, null, [column, length], {
                     "editColumn": column,
                     "deleteCount": length,
                     "insertText": name
@@ -5881,19 +5908,19 @@ module.exports = {
               _loop2();
             }
           };
-          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
             _loop();
           }
         } catch (err) {
-          _iterator2.e(err);
+          _iterator3.e(err);
         } finally {
-          _iterator2.f();
+          _iterator3.f();
         }
       }
     } catch (err) {
-      _iterator.e(err);
+      _iterator2.e(err);
     } finally {
-      _iterator.f();
+      _iterator2.f();
     }
   }
 };
@@ -6072,57 +6099,69 @@ module.exports = {
 
 
 
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 var _require = __webpack_require__(/*! ../helpers */ "../helpers/helpers.js"),
   addError = _require.addError,
-  emphasisOrStrongStyleFor = _require.emphasisOrStrongStyleFor,
-  forEachInlineChild = _require.forEachInlineChild,
-  getNextChildToken = _require.getNextChildToken,
-  getRangeAndFixInfoIfFound = _require.getRangeAndFixInfoIfFound;
-var impl = function impl(params, onError, tagPrefix, asterisk, underline, style) {
-  var lastLineNumber = -1;
-  var instances = new Map();
-  forEachInlineChild(params, "".concat(tagPrefix, "_open"), function (token, parent) {
-    var lineNumber = token.lineNumber,
-      markup = token.markup;
-    var markupStyle = emphasisOrStrongStyleFor(markup);
-    if (style === "consistent") {
-      style = markupStyle;
-    }
-    if (style !== markupStyle) {
-      var rangeAndFixInfo = {};
-      var contentToken = getNextChildToken(parent, token, "text", "".concat(tagPrefix, "_close"));
-      if (contentToken) {
-        var content = contentToken.content;
-        var actual = "".concat(markup).concat(content).concat(markup);
-        var expectedMarkup = style === "asterisk" ? asterisk : underline;
-        var expected = "".concat(expectedMarkup).concat(content).concat(expectedMarkup);
-        if (lastLineNumber !== lineNumber) {
-          lastLineNumber = lineNumber;
-          instances.clear();
+  emphasisOrStrongStyleFor = _require.emphasisOrStrongStyleFor;
+var _require2 = __webpack_require__(/*! ../helpers/micromark.cjs */ "../helpers/micromark.cjs"),
+  filterByTypes = _require2.filterByTypes,
+  tokenIfType = _require2.tokenIfType;
+var intrawordRe = /\w/;
+var impl = function impl(params, onError, type, asterisk, underline) {
+  var style = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : "consistent";
+  var lines = params.lines,
+    parsers = params.parsers;
+  var emphasisTokens = filterByTypes(parsers.micromark.tokens, [type]);
+  var _iterator = _createForOfIteratorHelper(emphasisTokens),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var token = _step.value;
+      var children = token.children;
+      var childType = "".concat(type, "Sequence");
+      var startSequence = tokenIfType(children[0], childType);
+      var endSequence = tokenIfType(children[children.length - 1], childType);
+      if (startSequence && endSequence) {
+        var markupStyle = emphasisOrStrongStyleFor(startSequence.text);
+        if (style === "consistent") {
+          style = markupStyle;
+        }
+        if (style !== markupStyle) {
+          var underscoreIntraword = style === "underscore" && (intrawordRe.test(lines[startSequence.startLine - 1][startSequence.startColumn - 2]) || intrawordRe.test(lines[endSequence.endLine - 1][endSequence.endColumn - 1]));
+          if (!underscoreIntraword) {
+            for (var _i = 0, _arr = [startSequence, endSequence]; _i < _arr.length; _i++) {
+              var sequence = _arr[_i];
+              addError(onError, sequence.startLine, "Expected: ".concat(style, "; Actual: ").concat(markupStyle), undefined, [sequence.startColumn, sequence.text.length], {
+                "editColumn": sequence.startColumn,
+                "deleteCount": sequence.text.length,
+                "insertText": style === "asterisk" ? asterisk : underline
+              });
+            }
+          }
         }
-        var instance = (instances.get(expected) || 0) + 1;
-        instances.set(expected, instance);
-        rangeAndFixInfo = getRangeAndFixInfoIfFound(params.lines, lineNumber - 1, actual, expected, instance);
       }
-      addError(onError, lineNumber, "Expected: ".concat(style, "; Actual: ").concat(markupStyle), null, rangeAndFixInfo.range, rangeAndFixInfo.fixInfo);
     }
-  });
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
 };
 module.exports = [{
   "names": ["MD049", "emphasis-style"],
   "description": "Emphasis style should be consistent",
   "tags": ["emphasis"],
   "function": function MD049(params, onError) {
-    var style = String(params.config.style || "consistent");
-    return impl(params, onError, "em", "*", "_", style);
+    return impl(params, onError, "emphasis", "*", "_", params.config.style || undefined);
   }
 }, {
   "names": ["MD050", "strong-style"],
   "description": "Strong style should be consistent",
   "tags": ["emphasis"],
   "function": function MD050(params, onError) {
-    var style = String(params.config.style || "consistent");
-    return impl(params, onError, "strong", "**", "__", style);
+    return impl(params, onError, "strong", "**", "__", params.config.style || undefined);
   }
 }];
 

package/helpers/helpers.js

@@ -1080,66 +1080,6 @@ function applyFixes(input, errors) {
 }
 module.exports.applyFixes = applyFixes;
 
-/**
- * Gets the range and fixInfo values for reporting an error if the expected
- * text is found on the specified line.
- *
- * @param {string[]} lines Lines of Markdown content.
- * @param {number} lineIndex Line index to check.
- * @param {string} search Text to search for.
- * @param {string} replace Text to replace with.
- * @param {number} [instance] Instance on the line (1-based).
- * @returns {Object} Range and fixInfo wrapper.
- */
-module.exports.getRangeAndFixInfoIfFound =
-  (lines, lineIndex, search, replace, instance = 1) => {
-    let range = null;
-    let fixInfo = null;
-    let searchIndex = -1;
-    while (instance > 0) {
-      searchIndex = lines[lineIndex].indexOf(search, searchIndex + 1);
-      instance--;
-    }
-    if (searchIndex !== -1) {
-      const column = searchIndex + 1;
-      const length = search.length;
-      range = [ column, length ];
-      fixInfo = {
-        "editColumn": column,
-        "deleteCount": length,
-        "insertText": replace
-      };
-    }
-    return {
-      range,
-      fixInfo
-    };
-  };
-
-/**
- * Gets the next (subsequent) child token if it is of the expected type.
- *
- * @param {Object} parentToken Parent token.
- * @param {Object} childToken Child token basis.
- * @param {string} nextType Token type of next token.
- * @param {string} nextNextType Token type of next-next token.
- * @returns {Object} Next token.
- */
-function getNextChildToken(parentToken, childToken, nextType, nextNextType) {
-  const { children } = parentToken;
-  const index = children.indexOf(childToken);
-  if (
-    (index !== -1) &&
-    (children.length > index + 2) &&
-    (children[index + 1].type === nextType) &&
-    (children[index + 2].type === nextNextType)
-  ) {
-    return children[index + 1];
-  }
-  return null;
-}
-module.exports.getNextChildToken = getNextChildToken;
-
 /**
  * Expands a path with a tilde to an absolute path.
  *

package/helpers/micromark.cjs

@@ -26,9 +26,10 @@ const {
  *
  * @param {string} markdown Markdown document.
  * @param {Object} [options] Options for micromark.
+ * @param {boolean} [refsDefined] Whether to treat references as defined.
  * @returns {Object[]} Micromark events.
  */
-function getMicromarkEvents(markdown, options = {}) {
+function getMicromarkEvents(markdown, options = {}, refsDefined = true) {
 
   // Customize options object to add useful extensions
   options.extensions = options.extensions || [];
@@ -38,8 +39,10 @@ function getMicromarkEvents(markdown, options = {}) {
   const encoding = undefined;
   const eol = true;
   const parseContext = parse(options);
-  // Customize ParseContext to treat all references as defined
-  parseContext.defined.includes = (searchElement) => searchElement.length > 0;
+  if (refsDefined) {
+    // Customize ParseContext to treat all references as defined
+    parseContext.defined.includes = (searchElement) => searchElement.length > 0;
+  }
   const chunks = preprocess()(markdown, encoding, eol);
   const events = postprocess(parseContext.document().write(chunks));
   return events;
@@ -50,12 +53,14 @@ function getMicromarkEvents(markdown, options = {}) {
  *
  * @param {string} markdown Markdown document.
  * @param {Object} [options] Options for micromark.
+ * @param {boolean} [refsDefined] Whether to treat references as defined.
  * @returns {Token[]} Micromark tokens (frozen).
  */
-function micromarkParse(markdown, options = {}) {
+function micromarkParse(markdown, options = {}, refsDefined = true) {
 
   // Use micromark to parse document into Events
-  const events = getMicromarkEvents(markdown, options);
+  const events =
+    getMicromarkEvents(markdown, options, refsDefined);
 
   // Create Token objects
   const document = [];
@@ -68,12 +73,7 @@ function micromarkParse(markdown, options = {}) {
     const { type, start, end } = token;
     const { "column": startColumn, "line": startLine } = start;
     const { "column": endColumn, "line": endLine } = end;
-    let text = null;
-    try {
-      text = context.sliceSerialize(token);
-    } catch {
-      // https://github.com/micromark/micromark/issues/131
-    }
+    const text = context.sliceSerialize(token);
     if (kind === "enter") {
       const previous = current;
       history.push(previous);
@@ -100,6 +100,25 @@ function micromarkParse(markdown, options = {}) {
   return document;
 }
 
+// /**
+//  * Log the structure of a Micromark token list.
+//  *
+//  * @param {Token[]} tokens Micromark tokens.
+//  * @param {number} depth Tree depth.
+//  * @returns {void}
+//  */
+// function consoleLogTokens(tokens, depth = 0) {
+//   for (const token of tokens) {
+//     const { children, text, type } = token;
+//     console.log(
+//       `${" ".repeat(depth * 2)}${type} ${text.replace(/\n/g, "\\n")}`
+//     );
+//     if (children.length > 0) {
+//       consoleLogTokens(children, depth + 1);
+//     }
+//   }
+// }
+
 /**
  * Filter a list of Micromark tokens by predicate.
  *
@@ -198,6 +217,17 @@ function matchAndGetTokensByType(tokens, matchTypes, resultTypes) {
   return result;
 }
 
+/**
+ * Returns the specified token iff it is of the desired type.
+ *
+ * @param {Token} token Micromark token candidate.
+ * @param {string} type Desired type.
+ * @returns {Token | null} Token instance.
+ */
+function tokenIfType(token, type) {
+  return (token && (token.type === type)) ? token : null;
+}
+
 module.exports = {
   "parse": micromarkParse,
   filterByPredicate,
@@ -205,5 +235,6 @@ module.exports = {
   getHtmlTagInfo,
   getMicromarkEvents,
   getTokenTextByType,
-  matchAndGetTokensByType
+  matchAndGetTokensByType,
+  tokenIfType
 };

package/helpers/package.json

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

package/lib/constants.js

@@ -11,4 +11,4 @@ module.exports.fixableRuleNames = [
   "MD044", "MD047", "MD049", "MD050", "MD051", "MD053"
 ];
 module.exports.homepage = "https://github.com/DavidAnson/markdownlint";
-module.exports.version = "0.28.2";
+module.exports.version = "0.29.0";

package/lib/md034.js

@@ -3,7 +3,7 @@
 "use strict";
 
 const { addErrorContext } = require("../helpers");
-const { filterByPredicate, getHtmlTagInfo } =
+const { filterByPredicate, getHtmlTagInfo, parse } =
   require("../helpers/micromark.cjs");
 
 module.exports = {
@@ -11,9 +11,9 @@ module.exports = {
   "description": "Bare URL used",
   "tags": [ "links", "url" ],
   "function": function MD034(params, onError) {
-    const literalAutolinks =
+    const literalAutolinks = (tokens) => (
       filterByPredicate(
-        params.parsers.micromark.tokens,
+        tokens,
         (token) => token.type === "literalAutolink",
         (token) => {
           const { children } = token;
@@ -43,26 +43,33 @@ module.exports = {
             }
           }
           return result;
-        });
-    for (const token of literalAutolinks) {
-      const range = [
-        token.startColumn,
-        token.endColumn - token.startColumn
-      ];
-      const fixInfo = {
-        "editColumn": range[0],
-        "deleteCount": range[1],
-        "insertText": `<${token.text}>`
-      };
-      addErrorContext(
-        onError,
-        token.startLine,
-        token.text,
-        null,
-        null,
-        range,
-        fixInfo
-      );
+        }
+      )
+    );
+    if (literalAutolinks(params.parsers.micromark.tokens).length > 0) {
+      // Re-parse with correct link/image reference definition handling
+      const document = params.lines.join("\n");
+      const tokens = parse(document, undefined, false);
+      for (const token of literalAutolinks(tokens)) {
+        const range = [
+          token.startColumn,
+          token.endColumn - token.startColumn
+        ];
+        const fixInfo = {
+          "editColumn": range[0],
+          "deleteCount": range[1],
+          "insertText": `<${token.text}>`
+        };
+        addErrorContext(
+          onError,
+          token.startLine,
+          token.text,
+          null,
+          null,
+          range,
+          fixInfo
+        );
+      }
     }
   }
 };

package/lib/md037.js

@@ -7,11 +7,12 @@ const { addErrorContext, emphasisMarkersInContent, forEachLine, isBlankLine,
 const { htmlElementRanges, lineMetadata } = require("./cache");
 
 const emphasisRe = /(^|[^\\]|\\\\)(?:(\*{1,3})|(_{1,3}))/g;
-const embeddedUnderscoreRe = /([A-Za-z\d])_([A-Za-z\d])/g;
+const embeddedUnderscoreRe = /([A-Za-z\d])(_([A-Za-z\d]))+/g;
 const asteriskListItemMarkerRe = /^([\s>]*)\*(\s+)/;
 const leftSpaceRe = /^\s+/;
 const rightSpaceRe = /\s+$/;
 const tablePipeRe = /\|/;
+const allUnderscoresRe = /_/g;
 
 module.exports = {
   "names": [ "MD037", "no-space-in-emphasis" ],
@@ -102,7 +103,10 @@ module.exports = {
           // Emphasis has no meaning here
           return;
         }
-        let patchedLine = line.replace(embeddedUnderscoreRe, "$1 $2");
+        let patchedLine = line.replace(
+          embeddedUnderscoreRe,
+          (match) => match.replace(allUnderscoresRe, " ")
+        );
         if (onItemStart) {
           // Trim overlapping '*' list item marker
           patchedLine = patchedLine.replace(asteriskListItemMarkerRe, "$1 $2");

package/lib/md038.js

@@ -3,7 +3,7 @@
 "use strict";
 
 const { addErrorContext } = require("../helpers");
-const { filterByTypes } = require("../helpers/micromark.cjs");
+const { filterByTypes, tokenIfType } = require("../helpers/micromark.cjs");
 
 const leftSpaceRe = /^\s(?:[^`]|$)/;
 const rightSpaceRe = /[^`]\s$/;
@@ -17,7 +17,6 @@ const trimCodeText = (text, start, end) => {
   }
   return text;
 };
-const tokenIfType = (token, type) => token && (token.type === type) && token;
 
 module.exports = {
   "names": [ "MD038", "no-space-in-code" ],

package/lib/md044.js

@@ -2,7 +2,7 @@
 
 "use strict";
 
-const { addErrorDetailIf, escapeForRegExp, withinAnyRange } =
+const { addErrorDetailIf, escapeForRegExp, newLineRe, withinAnyRange } =
   require("../helpers");
 const { filterByPredicate, filterByTypes, parse } =
   require("../helpers/micromark.cjs");
@@ -30,14 +30,32 @@ module.exports = {
       scannedTypes.add("codeFlowValue");
       scannedTypes.add("codeTextData");
     }
+    const tokenAdjustments = new Map();
     const contentTokens =
       filterByPredicate(
         params.parsers.micromark.tokens,
         (token) => scannedTypes.has(token.type),
         (token) => {
           let { children } = token;
+          const { startLine, text } = token;
           if (!includeHtmlElements && (token.type === "htmlFlow")) {
-            children = children.slice(1, -1);
+            if (text.startsWith("<!--")) {
+              // Remove comment content
+              children = [];
+            } else {
+              // Re-parse to get htmlText elements for detailed tokenization
+              const htmlTextLines =
+                `<md044>\n${text}\n</md044>`.split(newLineRe);
+              children = parse(htmlTextLines.join(""));
+              const reTokens = [ ...children ];
+              for (const reToken of reTokens) {
+                tokenAdjustments.set(reToken, {
+                  htmlTextLines,
+                  startLine
+                });
+                reTokens.push(...reToken.children);
+              }
+            }
           }
           return children.filter((t) => !ignoredChildTypes.has(t.type));
         }
@@ -78,10 +96,22 @@ module.exports = {
               autoLinked.add(token);
             }
             if (!withinAnyRange(urlRanges, lineIndex, index, length)) {
-              const column = index + 1;
+              let lineNumber = token.startLine;
+              let column = index;
+              if (tokenAdjustments.has(token)) {
+                const { htmlTextLines, startLine } =
+                  tokenAdjustments.get(token);
+                let lineDelta = 0;
+                while (htmlTextLines[lineDelta].length <= column) {
+                  column -= htmlTextLines[lineDelta].length;
+                  lineDelta++;
+                }
+                lineNumber = startLine + lineDelta - 1;
+              }
+              column++;
               addErrorDetailIf(
                 onError,
-                token.startLine,
+                lineNumber,
                 name,
                 nameMatch,
                 null,

package/lib/md049-md050.js

@@ -2,54 +2,55 @@
 
 "use strict";
 
-const { addError, emphasisOrStrongStyleFor, forEachInlineChild,
-  getNextChildToken, getRangeAndFixInfoIfFound } = require("../helpers");
+const { addError, emphasisOrStrongStyleFor } = require("../helpers");
+const { filterByTypes, tokenIfType } = require("../helpers/micromark.cjs");
 
-const impl = (params, onError, tagPrefix, asterisk, underline, style) => {
-  let lastLineNumber = -1;
-  const instances = new Map();
-  forEachInlineChild(params, `${tagPrefix}_open`, (token, parent) => {
-    const { lineNumber, markup } = token;
-    const markupStyle = emphasisOrStrongStyleFor(markup);
-    if (style === "consistent") {
-      style = markupStyle;
-    }
-    if (style !== markupStyle) {
-      let rangeAndFixInfo = {};
-      const contentToken = getNextChildToken(
-        parent, token, "text", `${tagPrefix}_close`
-      );
-      if (contentToken) {
-        const { content } = contentToken;
-        const actual = `${markup}${content}${markup}`;
-        const expectedMarkup =
-          (style === "asterisk") ? asterisk : underline;
-        const expected = `${expectedMarkup}${content}${expectedMarkup}`;
-        if (lastLineNumber !== lineNumber) {
-          lastLineNumber = lineNumber;
-          instances.clear();
+const intrawordRe = /\w/;
+
+const impl =
+  (params, onError, type, asterisk, underline, style = "consistent") => {
+    const { lines, parsers } = params;
+    const emphasisTokens =
+      filterByTypes(parsers.micromark.tokens, [ type ]);
+    for (const token of emphasisTokens) {
+      const { children } = token;
+      const childType = `${type}Sequence`;
+      const startSequence = tokenIfType(children[0], childType);
+      const endSequence = tokenIfType(children[children.length - 1], childType);
+      if (startSequence && endSequence) {
+        const markupStyle = emphasisOrStrongStyleFor(startSequence.text);
+        if (style === "consistent") {
+          style = markupStyle;
+        }
+        if (style !== markupStyle) {
+          const underscoreIntraword = (style === "underscore") && (
+            intrawordRe.test(
+              lines[startSequence.startLine - 1][startSequence.startColumn - 2]
+            ) ||
+            intrawordRe.test(
+              lines[endSequence.endLine - 1][endSequence.endColumn - 1]
+            )
+          );
+          if (!underscoreIntraword) {
+            for (const sequence of [ startSequence, endSequence ]) {
+              addError(
+                onError,
+                sequence.startLine,
+                `Expected: ${style}; Actual: ${markupStyle}`,
+                undefined,
+                [ sequence.startColumn, sequence.text.length ],
+                {
+                  "editColumn": sequence.startColumn,
+                  "deleteCount": sequence.text.length,
+                  "insertText": (style === "asterisk") ? asterisk : underline
+                }
+              );
+            }
+          }
         }
-        const instance = (instances.get(expected) || 0) + 1;
-        instances.set(expected, instance);
-        rangeAndFixInfo = getRangeAndFixInfoIfFound(
-          params.lines,
-          lineNumber - 1,
-          actual,
-          expected,
-          instance
-        );
       }
-      addError(
-        onError,
-        lineNumber,
-        `Expected: ${style}; Actual: ${markupStyle}`,
-        null,
-        rangeAndFixInfo.range,
-        rangeAndFixInfo.fixInfo
-      );
     }
-  });
-};
+  };
 
 module.exports = [
   {
@@ -57,8 +58,14 @@ module.exports = [
     "description": "Emphasis style should be consistent",
     "tags": [ "emphasis" ],
     "function": function MD049(params, onError) {
-      const style = String(params.config.style || "consistent");
-      return impl(params, onError, "em", "*", "_", style);
+      return impl(
+        params,
+        onError,
+        "emphasis",
+        "*",
+        "_",
+        params.config.style || undefined
+      );
     }
   },
   {
@@ -66,8 +73,14 @@ module.exports = [
     "description": "Strong style should be consistent",
     "tags": [ "emphasis" ],
     "function": function MD050(params, onError) {
-      const style = String(params.config.style || "consistent");
-      return impl(params, onError, "strong", "**", "__", style);
+      return impl(
+        params,
+        onError,
+        "strong",
+        "**",
+        "__",
+        params.config.style || undefined
+      );
     }
   }
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdownlint",
-  "version": "0.28.2",
+  "version": "0.29.0",
   "description": "A Node.js style checker and lint tool for Markdown/CommonMark files.",
   "type": "commonjs",
   "main": "./lib/markdownlint.js",
@@ -26,14 +26,14 @@
     "build-config-example": "node schema/build-config-example.js",
     "build-config-schema": "node schema/build-config-schema.js",
     "build-declaration": "tsc --allowJs --declaration --emitDeclarationOnly --module commonjs --resolveJsonModule --target es2015 lib/markdownlint.js && node scripts delete 'lib/{c,md,r}*.d.ts' 'micromark/*.d.cts' 'helpers/*.d.{cts,ts}'",
-    "build-demo": "node scripts copy node_modules/markdown-it/dist/markdown-it.min.js demo/markdown-it.min.js && node scripts copy node_modules/markdownlint-micromark/micromark-browser.js demo/micromark-browser.js && cd demo && webpack --no-stats",
+    "build-demo": "node scripts copy node_modules/markdown-it/dist/markdown-it.min.js demo/markdown-it.min.js && node scripts copy node_modules/markdownlint-micromark/micromark-browser.js demo/micromark-browser.js && node scripts copy node_modules/markdownlint-micromark/micromark-html-browser.js demo/micromark-html-browser.js && cd demo && webpack --no-stats",
     "build-docs": "node doc-build/build-rules.mjs",
     "build-example": "npm install --no-save --ignore-scripts grunt grunt-cli gulp through2",
     "build-micromark": "cd micromark && npm run build",
     "ci": "npm-run-all --continue-on-error --parallel lint serial-config-docs serial-declaration-demo test-cover && git diff --exit-code",
     "clone-test-repos-apache-airflow": "cd test-repos && git clone https://github.com/apache/airflow apache-airflow --depth 1 --no-tags --quiet",
     "clone-test-repos-dotnet-docs": "cd test-repos && git clone https://github.com/dotnet/docs dotnet-docs --depth 1 --no-tags --quiet",
-    "clone-test-repos-electron-electron": "cd test-repos && git clone https://github.com/electron/electron electron-electron --depth 1 --no-tags --quiet",
+    "clone-test-repos-electron-electron": "cd test-repos && git clone https://github.com/electron/electron electron-electron --depth 1 --no-tags --quiet && cd electron-electron && npm install --ignore-scripts @electron/lint-roller",
     "clone-test-repos-eslint-eslint": "cd test-repos && git clone https://github.com/eslint/eslint eslint-eslint --depth 1 --no-tags --quiet",
     "clone-test-repos-mdn-content": "cd test-repos && git clone https://github.com/mdn/content mdn-content --depth 1 --no-tags --quiet",
     "clone-test-repos-mdn-translated-content": "cd test-repos && git clone https://github.com/mdn/translated-content mdn-translated-content --depth 1 --no-tags --quiet",
@@ -46,8 +46,9 @@
     "clone-test-repos": "mkdir test-repos && cd test-repos && npm run clone-test-repos-apache-airflow && npm run clone-test-repos-dotnet-docs && npm run clone-test-repos-electron-electron && npm run clone-test-repos-eslint-eslint && npm run clone-test-repos-mdn-content && npm run clone-test-repos-mdn-translated-content && npm run clone-test-repos-mkdocs-mkdocs && npm run clone-test-repos-mochajs-mocha && npm run clone-test-repos-pi-hole-docs && npm run clone-test-repos-v8-v8-dev && npm run clone-test-repos-webhintio-hint && npm run clone-test-repos-webpack-webpack-js-org",
     "declaration": "npm run build-declaration && npm run test-declaration",
     "example": "cd example && node standalone.js && grunt markdownlint --force && gulp markdownlint",
-    "docker-npm-install": "docker run --rm --tty --name npm-install --volume $PWD:/home/workdir --workdir /home/workdir --user node node:16 npm install",
-    "docker-npm-run-upgrade": "docker run --rm --tty --name npm-run-upgrade --volume $PWD:/home/workdir --workdir /home/workdir --user node node:16 npm run upgrade",
+    "docker-npm-install": "docker run --rm --tty --name npm-install --volume $PWD:/home/workdir --workdir /home/workdir --user node node:latest npm install",
+    "docker-npm-run-upgrade": "docker run --rm --tty --name npm-run-upgrade --volume $PWD:/home/workdir --workdir /home/workdir --user node node:latest npm run upgrade",
+    "install-micromark": "cd micromark && npm install --no-package-lock",
     "lint": "eslint --ext .js,.cjs,.mjs --max-warnings 0 .",
     "lint-test-repos": "ava --timeout=10m test/markdownlint-test-repos.js",
     "serial-config-docs": "npm run build-config && npm run build-docs",
@@ -60,24 +61,24 @@
     "upgrade": "npx --yes npm-check-updates --upgrade"
   },
   "engines": {
-    "node": ">=14.18.0"
+    "node": ">=16"
   },
   "dependencies": {
     "markdown-it": "13.0.1",
-    "markdownlint-micromark": "0.1.2"
+    "markdownlint-micromark": "0.1.5"
   },
   "devDependencies": {
-    "ava": "5.2.0",
+    "@babel/core": "7.22.1",
+    "@babel/preset-env": "7.22.4",
+    "ava": "5.3.0",
     "babel-loader": "9.1.2",
-    "@babel/core": "7.21.4",
-    "@babel/preset-env": "7.21.4",
-    "c8": "7.13.0",
-    "eslint": "8.39.0",
+    "c8": "7.14.0",
+    "eslint": "8.41.0",
     "eslint-plugin-es": "4.1.0",
-    "eslint-plugin-jsdoc": "43.0.7",
-    "eslint-plugin-n": "15.7.0",
-    "eslint-plugin-regexp": "1.14.0",
-    "eslint-plugin-unicorn": "46.0.0",
+    "eslint-plugin-jsdoc": "46.1.0",
+    "eslint-plugin-n": "16.0.0",
+    "eslint-plugin-regexp": "1.15.0",
+    "eslint-plugin-unicorn": "47.0.0",
     "globby": "13.1.4",
     "js-yaml": "4.1.0",
     "markdown-it-for-inline": "0.1.1",
@@ -87,13 +88,13 @@
     "markdownlint-rule-helpers": "0.19.0",
     "npm-run-all": "4.1.5",
     "strip-json-comments": "5.0.0",
-    "terser-webpack-plugin": "5.3.7",
+    "terser-webpack-plugin": "5.3.9",
     "toml": "3.0.0",
     "tv4": "1.3.0",
-    "typescript": "5.0.4",
-    "webpack": "5.81.0",
-    "webpack-cli": "5.0.2",
-    "yaml": "2.2.2"
+    "typescript": "5.1.3",
+    "webpack": "5.85.0",
+    "webpack-cli": "5.1.1",
+    "yaml": "2.3.1"
   },
   "keywords": [
     "markdown",