markdownlint 0.37.3 → 0.38.0

package/lib/parse-configuration.mjs

@@ -0,0 +1,46 @@
+// @ts-check
+
+/**
+ * Result of a call to parseConfiguration.
+ *
+ * @typedef {Object} ParseConfigurationResult
+ * @property {Object | null} config Configuration object if successful.
+ * @property {string | null} message Error message if an error occurred.
+ */
+
+/**
+ * Parse the content of a configuration file.
+ *
+ * @param {string} name Name of the configuration file.
+ * @param {string} content Configuration content.
+ * @param {import("./markdownlint.mjs").ConfigurationParser[]} [parsers] Parsing function(s).
+ * @returns {ParseConfigurationResult} Parse configuration result.
+ */
+export default function parseConfiguration(name, content, parsers) {
+  let config = null;
+  let message = null;
+  const errors = [];
+  let index = 0;
+  // Try each parser
+  const failed = (parsers || [ JSON.parse ]).every((parser) => {
+    try {
+      const result = parser(content);
+      config = (result && (typeof result === "object") && !Array.isArray(result)) ? result : {};
+      // Succeeded
+      return false;
+    } catch (error) {
+      errors.push(`Parser ${index++}: ${error.message}`);
+    }
+    // Failed, try the next parser
+    return true;
+  });
+  // Message if unable to parse
+  if (failed) {
+    errors.unshift(`Unable to parse '${name}'`);
+    message = errors.join("; ");
+  }
+  return {
+    config,
+    message
+  };
+}

package/lib/resolve-module.cjs

@@ -0,0 +1,52 @@
+// @ts-check
+
+"use strict";
+
+// @ts-ignore
+// eslint-disable-next-line camelcase, no-inline-comments, no-undef
+const nativeRequire = (typeof __non_webpack_require__ === "undefined") ? require : /* c8 ignore next */ __non_webpack_require__;
+// Captures the native require implementation (even under webpack).
+
+/**
+ * @typedef RequireResolveOptions
+ * @property {string[]} [paths] Additional paths to resolve from.
+ */
+
+/**
+ * @callback RequireResolve
+ * @param {string} id Module name or path.
+ * @param {RequireResolveOptions} options Options to apply.
+ * @returns {string} Resolved module path.
+ */
+
+/**
+ * Resolves modules according to Node's resolution rules.
+ *
+ * @param {RequireResolve} resolve Node-like require.resolve implementation.
+ * @param {string} id Module name or path.
+ * @param {string[]} [paths] Additional paths to resolve from.
+ * @returns {string} Resolved module path.
+ */
+const resolveModuleCustomResolve = (resolve, id, paths = []) => {
+  // resolve.paths is sometimes not present under webpack or VS Code
+  // @ts-ignore
+  const resolvePaths = resolve.paths?.("") || [];
+  const allPaths = [ ...paths, ...resolvePaths ];
+  return resolve(id, { "paths": allPaths });
+};
+
+/**
+ * Resolves modules according to Node's resolution rules.
+ *
+ * @param {string} id Module name or path.
+ * @param {string[]} [paths] Additional paths to resolve from.
+ * @returns {string} Resolved module path.
+ */
+const resolveModule = (id, paths) => (
+  resolveModuleCustomResolve(nativeRequire.resolve, id, paths)
+);
+
+module.exports = {
+  resolveModule,
+  resolveModuleCustomResolve
+};

package/lib/resolve-module.d.cts

@@ -0,0 +1,34 @@
+export type RequireResolveOptions = {
+    /**
+     * Additional paths to resolve from.
+     */
+    paths?: string[];
+};
+export type RequireResolve = (id: string, options: RequireResolveOptions) => string;
+/**
+ * Resolves modules according to Node's resolution rules.
+ *
+ * @param {string} id Module name or path.
+ * @param {string[]} [paths] Additional paths to resolve from.
+ * @returns {string} Resolved module path.
+ */
+export function resolveModule(id: string, paths?: string[]): string;
+/**
+ * @typedef RequireResolveOptions
+ * @property {string[]} [paths] Additional paths to resolve from.
+ */
+/**
+ * @callback RequireResolve
+ * @param {string} id Module name or path.
+ * @param {RequireResolveOptions} options Options to apply.
+ * @returns {string} Resolved module path.
+ */
+/**
+ * Resolves modules according to Node's resolution rules.
+ *
+ * @param {RequireResolve} resolve Node-like require.resolve implementation.
+ * @param {string} id Module name or path.
+ * @param {string[]} [paths] Additional paths to resolve from.
+ * @returns {string} Resolved module path.
+ */
+export function resolveModuleCustomResolve(resolve: RequireResolve, id: string, paths?: string[]): string;

package/lib/rules.mjs

@@ -53,6 +53,7 @@ import md054 from "./md054.mjs";
 import md055 from "./md055.mjs";
 import md056 from "./md056.mjs";
 import md058 from "./md058.mjs";
+import md059 from "./md059.mjs";
 
 const rules = [
   md001,
@@ -108,7 +109,8 @@ const rules = [
   md055,
   md056,
   // md057: See https://github.com/markdownlint/markdownlint
-  md058
+  md058,
+  md059
 ];
 for (const rule of rules) {
   const name = rule.names[0].toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdownlint",
-  "version": "0.37.3",
+  "version": "0.38.0",
   "description": "A Node.js style checker and lint tool for Markdown/CommonMark files.",
   "type": "module",
   "exports": {
@@ -36,11 +36,11 @@
     "build-config": "npm run build-config-schema && npm run build-config-example",
     "build-config-example": "node schema/build-config-example.mjs",
     "build-config-schema": "node schema/build-config-schema.mjs",
-    "build-declaration": "tsc --allowJs --checkJs --declaration --emitDeclarationOnly --module nodenext --outDir dts --rootDir . --target es2015 lib/exports.mjs lib/exports-async.mjs lib/exports-promise.mjs lib/exports-sync.mjs lib/markdownlint.mjs && node scripts/index.mjs copy dts/lib/exports.d.mts lib/exports.d.mts && node scripts/index.mjs copy dts/lib/exports-async.d.mts lib/exports-async.d.mts && node scripts/index.mjs copy dts/lib/exports-promise.d.mts lib/exports-promise.d.mts && node scripts/index.mjs copy dts/lib/exports-sync.d.mts lib/exports-sync.d.mts && node scripts/index.mjs copy dts/lib/markdownlint.d.mts lib/markdownlint.d.mts && node scripts/index.mjs remove dts",
+    "build-declaration": "tsc --allowJs --checkJs --declaration --emitDeclarationOnly --module nodenext --outDir dts --rootDir . --target es2015 lib/exports.mjs lib/exports-async.mjs lib/exports-promise.mjs lib/exports-sync.mjs lib/markdownlint.mjs lib/resolve-module.cjs && node scripts/index.mjs copy dts/lib/exports.d.mts lib/exports.d.mts && node scripts/index.mjs copy dts/lib/exports-async.d.mts lib/exports-async.d.mts && node scripts/index.mjs copy dts/lib/exports-promise.d.mts lib/exports-promise.d.mts && node scripts/index.mjs copy dts/lib/exports-sync.d.mts lib/exports-sync.d.mts && node scripts/index.mjs copy dts/lib/markdownlint.d.mts lib/markdownlint.d.mts && node scripts/index.mjs copy dts/lib/resolve-module.d.cts lib/resolve-module.d.cts && node scripts/index.mjs remove dts",
     "build-demo": "node scripts/index.mjs copy node_modules/markdown-it/dist/markdown-it.min.js demo/markdown-it.min.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",
-    "ci": "npm-run-all --continue-on-error --parallel lint serial-config-docs serial-declaration-demo test-cover && git diff --exit-code",
+    "ci": "npm-run-all --continue-on-error --parallel build-demo lint serial-config-docs serial-declaration 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 && cd electron-electron && npm install --ignore-scripts @electron/lint-roller typescript@4",
@@ -58,56 +58,59 @@
     "lint": "eslint --max-warnings 0",
     "lint-test-repos": "ava --timeout=10m test/markdownlint-test-repos-*.mjs",
     "serial-config-docs": "npm run build-config && npm run build-docs",
-    "serial-declaration-demo": "npm run build-declaration && npm-run-all --continue-on-error --parallel build-demo test-declaration",
-    "test": "ava --timeout=30s test/markdownlint-test.mjs test/markdownlint-test-config.mjs test/markdownlint-test-custom-rules.mjs test/markdownlint-test-fixes.mjs test/markdownlint-test-helpers.mjs test/markdownlint-test-micromark.mjs test/markdownlint-test-result-object.mjs test/markdownlint-test-scenarios.mjs helpers/test.cjs",
+    "serial-declaration": "npm run build-declaration && npm run test-declaration",
+    "test": "ava --timeout=30s test/markdownlint-test.mjs test/markdownlint-test-config.mjs test/markdownlint-test-custom-rules.mjs test/markdownlint-test-exports.mjs test/markdownlint-test-fixes.mjs test/markdownlint-test-helpers.mjs test/markdownlint-test-micromark.mjs test/markdownlint-test-project.mjs test/markdownlint-test-result-object.mjs test/markdownlint-test-scenarios.mjs test/parse-configuration-test.mjs test/resolve-module-test.mjs helpers/test.cjs",
     "test-cover": "c8 --100 npm test",
-    "test-declaration": "cd example/typescript && tsc --module commonjs && tsc --module nodenext && node type-check.js",
+    "test-declaration": "npm-run-all --continue-on-error --parallel test-declaration-cts test-declaration-mts",
+    "test-declaration-cts": "cd example/typescript && node ../../scripts/index.mjs copy type-check.ts type-check-commonjs.cts && tsc --module commonjs --esModuleInterop type-check-commonjs.cts",
+    "test-declaration-mts": "cd example/typescript && node ../../scripts/index.mjs copy type-check.ts type-check-nodenext.mts && tsc --module nodenext                   type-check-nodenext.mts && node type-check-nodenext.mjs",
     "test-extra": "ava --timeout=10m test/markdownlint-test-extra-parse.mjs test/markdownlint-test-extra-type.mjs",
-    "update-snapshots": "ava --update-snapshots test/markdownlint-test-custom-rules.mjs test/markdownlint-test-micromark.mjs test/markdownlint-test-scenarios.mjs",
+    "update-snapshots": "ava --update-snapshots test/markdownlint-test-custom-rules.mjs test/markdownlint-test-exports.mjs test/markdownlint-test-micromark.mjs test/markdownlint-test-scenarios.mjs",
     "update-snapshots-test-repos": "ava --timeout=10m --update-snapshots test/markdownlint-test-repos-*.mjs",
+    "update-test-repos": "node scripts/index.mjs remove ./test-repos && npm run clone-test-repos && npm run update-snapshots-test-repos",
     "upgrade": "npx --yes npm-check-updates --upgrade"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
-    "markdown-it": "14.1.0",
-    "micromark": "4.0.1",
-    "micromark-core-commonmark": "2.0.2",
-    "micromark-extension-directive": "3.0.2",
+    "micromark": "4.0.2",
+    "micromark-core-commonmark": "2.0.3",
+    "micromark-extension-directive": "4.0.0",
     "micromark-extension-gfm-autolink-literal": "2.1.0",
     "micromark-extension-gfm-footnote": "2.1.0",
-    "micromark-extension-gfm-table": "2.1.0",
+    "micromark-extension-gfm-table": "2.1.1",
     "micromark-extension-math": "3.1.0",
-    "micromark-util-types": "2.0.1"
+    "micromark-util-types": "2.0.2"
   },
   "devDependencies": {
-    "@eslint/js": "9.17.0",
-    "@stylistic/eslint-plugin": "2.12.1",
+    "@eslint/js": "9.26.0",
+    "@stylistic/eslint-plugin": "4.2.0",
     "ajv": "8.17.1",
-    "ava": "6.2.0",
+    "ava": "6.3.0",
     "c8": "10.1.3",
     "character-entities": "2.0.2",
-    "eslint": "9.17.0",
-    "eslint-plugin-jsdoc": "50.6.1",
-    "eslint-plugin-n": "17.15.1",
+    "eslint": "9.26.0",
+    "eslint-plugin-jsdoc": "50.6.11",
+    "eslint-plugin-n": "17.17.0",
     "eslint-plugin-regexp": "2.7.0",
-    "eslint-plugin-unicorn": "56.0.1",
+    "eslint-plugin-unicorn": "59.0.0",
     "gemoji": "8.1.0",
-    "globby": "14.0.2",
+    "globby": "14.1.0",
     "js-yaml": "4.1.0",
-    "json-schema-to-typescript": "15.0.3",
+    "json-schema-to-typescript": "15.0.4",
     "jsonc-parser": "3.3.1",
+    "markdown-it": "14.1.0",
     "markdown-it-for-inline": "2.0.1",
     "markdown-it-sub": "2.0.0",
     "markdown-it-sup": "2.0.0",
-    "markdownlint-rule-extended-ascii": "0.1.0",
+    "markdownlint-rule-extended-ascii": "0.2.1",
     "nano-spawn": "0.2.0",
     "npm-run-all": "4.1.5",
-    "terser-webpack-plugin": "5.3.11",
+    "terser-webpack-plugin": "5.3.14",
     "toml": "3.0.0",
-    "typescript": "5.7.2",
-    "webpack": "5.97.1",
+    "typescript": "5.8.3",
+    "webpack": "5.99.7",
     "webpack-cli": "6.0.1"
   },
   "keywords": [

package/schema/.markdownlint.jsonc

@@ -7,25 +7,25 @@
   // Path to configuration file to extend
   "extends": null,
 
-  // MD001/heading-increment : Heading levels should only increment by one level at a time : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md001.md
+  // MD001/heading-increment : Heading levels should only increment by one level at a time : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md001.md
   "MD001": true,
 
-  // MD003/heading-style : Heading style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md003.md
+  // MD003/heading-style : Heading style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md003.md
   "MD003": {
     // Heading style
     "style": "consistent"
   },
 
-  // MD004/ul-style : Unordered list style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md004.md
+  // MD004/ul-style : Unordered list style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md004.md
   "MD004": {
     // List style
     "style": "consistent"
   },
 
-  // MD005/list-indent : Inconsistent indentation for list items at the same level : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md005.md
+  // MD005/list-indent : Inconsistent indentation for list items at the same level : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md005.md
   "MD005": true,
 
-  // MD007/ul-indent : Unordered list indentation : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md007.md
+  // MD007/ul-indent : Unordered list indentation : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md007.md
   "MD007": {
     // Spaces for indent
     "indent": 2,
@@ -35,7 +35,7 @@
     "start_indent": 2
   },
 
-  // MD009/no-trailing-spaces : Trailing spaces : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md009.md
+  // MD009/no-trailing-spaces : Trailing spaces : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
   "MD009": {
     // Spaces for line break
     "br_spaces": 2,
@@ -45,7 +45,7 @@
     "strict": false
   },
 
-  // MD010/no-hard-tabs : Hard tabs : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md010.md
+  // MD010/no-hard-tabs : Hard tabs : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md010.md
   "MD010": {
     // Include code blocks
     "code_blocks": true,
@@ -55,16 +55,16 @@
     "spaces_per_tab": 1
   },
 
-  // MD011/no-reversed-links : Reversed link syntax : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md011.md
+  // MD011/no-reversed-links : Reversed link syntax : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md011.md
   "MD011": true,
 
-  // MD012/no-multiple-blanks : Multiple consecutive blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md012.md
+  // MD012/no-multiple-blanks : Multiple consecutive blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md012.md
   "MD012": {
     // Consecutive blank lines
     "maximum": 1
   },
 
-  // MD013/line-length : Line length : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md013.md
+  // MD013/line-length : Line length : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md013.md
   "MD013": {
     // Number of characters
     "line_length": 80,
@@ -84,22 +84,22 @@
     "stern": false
   },
 
-  // MD014/commands-show-output : Dollar signs used before commands without showing output : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md014.md
+  // MD014/commands-show-output : Dollar signs used before commands without showing output : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md014.md
   "MD014": true,
 
-  // MD018/no-missing-space-atx : No space after hash on atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md018.md
+  // MD018/no-missing-space-atx : No space after hash on atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md018.md
   "MD018": true,
 
-  // MD019/no-multiple-space-atx : Multiple spaces after hash on atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md019.md
+  // MD019/no-multiple-space-atx : Multiple spaces after hash on atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md019.md
   "MD019": true,
 
-  // MD020/no-missing-space-closed-atx : No space inside hashes on closed atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md020.md
+  // MD020/no-missing-space-closed-atx : No space inside hashes on closed atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md020.md
   "MD020": true,
 
-  // MD021/no-multiple-space-closed-atx : Multiple spaces inside hashes on closed atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md021.md
+  // MD021/no-multiple-space-closed-atx : Multiple spaces inside hashes on closed atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md021.md
   "MD021": true,
 
-  // MD022/blanks-around-headings : Headings should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md022.md
+  // MD022/blanks-around-headings : Headings should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md022.md
   "MD022": {
     // Blank lines above heading
     "lines_above": 1,
@@ -107,42 +107,45 @@
     "lines_below": 1
   },
 
-  // MD023/heading-start-left : Headings must start at the beginning of the line : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md023.md
+  // MD023/heading-start-left : Headings must start at the beginning of the line : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md023.md
   "MD023": true,
 
-  // MD024/no-duplicate-heading : Multiple headings with the same content : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md024.md
+  // MD024/no-duplicate-heading : Multiple headings with the same content : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md024.md
   "MD024": {
     // Only check sibling headings
     "siblings_only": false
   },
 
-  // MD025/single-title/single-h1 : Multiple top-level headings in the same document : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md025.md
+  // MD025/single-title/single-h1 : Multiple top-level headings in the same document : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md025.md
   "MD025": {
-    // Heading level
-    "level": 1,
     // RegExp for matching title in front matter
-    "front_matter_title": "^\\s*title\\s*[:=]"
+    "front_matter_title": "^\\s*title\\s*[:=]",
+    // Heading level
+    "level": 1
   },
 
-  // MD026/no-trailing-punctuation : Trailing punctuation in heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md026.md
+  // MD026/no-trailing-punctuation : Trailing punctuation in heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md026.md
   "MD026": {
     // Punctuation characters
     "punctuation": ".,;:!。，；：！"
   },
 
-  // MD027/no-multiple-space-blockquote : Multiple spaces after blockquote symbol : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md027.md
-  "MD027": true,
+  // MD027/no-multiple-space-blockquote : Multiple spaces after blockquote symbol : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md027.md
+  "MD027": {
+    // Include list items
+    "list_items": true
+  },
 
-  // MD028/no-blanks-blockquote : Blank line inside blockquote : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md028.md
+  // MD028/no-blanks-blockquote : Blank line inside blockquote : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md028.md
   "MD028": true,
 
-  // MD029/ol-prefix : Ordered list item prefix : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md029.md
+  // MD029/ol-prefix : Ordered list item prefix : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md029.md
   "MD029": {
     // List style
     "style": "one_or_ordered"
   },
 
-  // MD030/list-marker-space : Spaces after list markers : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md030.md
+  // MD030/list-marker-space : Spaces after list markers : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md030.md
   "MD030": {
     // Spaces for single-line unordered list items
     "ul_single": 1,
@@ -154,46 +157,46 @@
     "ol_multi": 1
   },
 
-  // MD031/blanks-around-fences : Fenced code blocks should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md031.md
+  // MD031/blanks-around-fences : Fenced code blocks should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md031.md
   "MD031": {
     // Include list items
     "list_items": true
   },
 
-  // MD032/blanks-around-lists : Lists should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md032.md
+  // MD032/blanks-around-lists : Lists should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md032.md
   "MD032": true,
 
-  // MD033/no-inline-html : Inline HTML : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md033.md
+  // MD033/no-inline-html : Inline HTML : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md033.md
   "MD033": {
     // Allowed elements
     "allowed_elements": []
   },
 
-  // MD034/no-bare-urls : Bare URL used : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md034.md
+  // MD034/no-bare-urls : Bare URL used : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md034.md
   "MD034": true,
 
-  // MD035/hr-style : Horizontal rule style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md035.md
+  // MD035/hr-style : Horizontal rule style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md035.md
   "MD035": {
     // Horizontal rule style
     "style": "consistent"
   },
 
-  // MD036/no-emphasis-as-heading : Emphasis used instead of a heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md036.md
+  // MD036/no-emphasis-as-heading : Emphasis used instead of a heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md036.md
   "MD036": {
     // Punctuation characters
     "punctuation": ".,;:!?。，；：！？"
   },
 
-  // MD037/no-space-in-emphasis : Spaces inside emphasis markers : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md037.md
+  // MD037/no-space-in-emphasis : Spaces inside emphasis markers : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md037.md
   "MD037": true,
 
-  // MD038/no-space-in-code : Spaces inside code span elements : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md038.md
+  // MD038/no-space-in-code : Spaces inside code span elements : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md038.md
   "MD038": true,
 
-  // MD039/no-space-in-links : Spaces inside link text : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md039.md
+  // MD039/no-space-in-links : Spaces inside link text : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md039.md
   "MD039": true,
 
-  // MD040/fenced-code-language : Fenced code blocks should have a language specified : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md040.md
+  // MD040/fenced-code-language : Fenced code blocks should have a language specified : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md040.md
   "MD040": {
     // List of languages
     "allowed_languages": [],
@@ -201,18 +204,20 @@
     "language_only": false
   },
 
-  // MD041/first-line-heading/first-line-h1 : First line in a file should be a top-level heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md041.md
+  // MD041/first-line-heading/first-line-h1 : First line in a file should be a top-level heading : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md041.md
   "MD041": {
-    // Heading level
-    "level": 1,
+    // Allow content before first heading
+    "allow_preamble": false,
     // RegExp for matching title in front matter
-    "front_matter_title": "^\\s*title\\s*[:=]"
+    "front_matter_title": "^\\s*title\\s*[:=]",
+    // Heading level
+    "level": 1
   },
 
-  // MD042/no-empty-links : No empty links : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md042.md
+  // MD042/no-empty-links : No empty links : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md042.md
   "MD042": true,
 
-  // MD043/required-headings : Required heading structure : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md043.md
+  // MD043/required-headings : Required heading structure : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md043.md
   "MD043": {
     // List of headings
     "headings": [],
@@ -220,7 +225,7 @@
     "match_case": false
   },
 
-  // MD044/proper-names : Proper names should have the correct capitalization : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md044.md
+  // MD044/proper-names : Proper names should have the correct capitalization : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md044.md
   "MD044": {
     // List of proper names
     "names": [],
@@ -230,49 +235,55 @@
     "html_elements": true
   },
 
-  // MD045/no-alt-text : Images should have alternate text (alt text) : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md045.md
+  // MD045/no-alt-text : Images should have alternate text (alt text) : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md045.md
   "MD045": true,
 
-  // MD046/code-block-style : Code block style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md046.md
+  // MD046/code-block-style : Code block style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md046.md
   "MD046": {
     // Block style
     "style": "consistent"
   },
 
-  // MD047/single-trailing-newline : Files should end with a single newline character : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md047.md
+  // MD047/single-trailing-newline : Files should end with a single newline character : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md047.md
   "MD047": true,
 
-  // MD048/code-fence-style : Code fence style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md048.md
+  // MD048/code-fence-style : Code fence style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md048.md
   "MD048": {
     // Code fence style
     "style": "consistent"
   },
 
-  // MD049/emphasis-style : Emphasis style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md049.md
+  // MD049/emphasis-style : Emphasis style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md049.md
   "MD049": {
     // Emphasis style
     "style": "consistent"
   },
 
-  // MD050/strong-style : Strong style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md050.md
+  // MD050/strong-style : Strong style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md050.md
   "MD050": {
     // Strong style
     "style": "consistent"
   },
 
-  // MD051/link-fragments : Link fragments should be valid : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md051.md
+  // MD051/link-fragments : Link fragments should be valid : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md051.md
   "MD051": {
     // Ignore case of fragments
-    "ignore_case": false
+    "ignore_case": false,
+    // Pattern for ignoring additional fragments
+    "ignored_pattern": ""
   },
 
-  // MD052/reference-links-images : Reference links and images should use a label that is defined : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md052.md
+  // MD052/reference-links-images : Reference links and images should use a label that is defined : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md052.md
   "MD052": {
+    // Ignored link labels
+    "ignored_labels": [
+      "x"
+    ],
     // Include shortcut syntax
     "shortcut_syntax": false
   },
 
-  // MD053/link-image-reference-definitions : Link and image reference definitions should be needed : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md053.md
+  // MD053/link-image-reference-definitions : Link and image reference definitions should be needed : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md053.md
   "MD053": {
     // Ignored definitions
     "ignored_definitions": [
@@ -280,7 +291,7 @@
     ]
   },
 
-  // MD054/link-image-style : Link and image style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md054.md
+  // MD054/link-image-style : Link and image style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md054.md
   "MD054": {
     // Allow autolinks
     "autolink": true,
@@ -296,15 +307,26 @@
     "url_inline": true
   },
 
-  // MD055/table-pipe-style : Table pipe style : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md055.md
+  // MD055/table-pipe-style : Table pipe style : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md055.md
   "MD055": {
     // Table pipe style
     "style": "consistent"
   },
 
-  // MD056/table-column-count : Table column count : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md056.md
+  // MD056/table-column-count : Table column count : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md056.md
   "MD056": true,
 
-  // MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.3/doc/md058.md
-  "MD058": true
+  // MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md058.md
+  "MD058": true,
+
+  // MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md059.md
+  "MD059": {
+    // Prohibited link texts
+    "prohibited_texts": [
+      "click here",
+      "here",
+      "link",
+      "more"
+    ]
+  }
 }