Allow use of Markdown in description and notes

api/HTMLAnchorElement.json

@@ -621,7 +621,7 @@
             },
             "firefox": {
               "version_added": "1",
-              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of <code>https://z.com/x?a=true&amp;b=false</code>, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
+              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of `https://z.com/x?a=true&amp;b=false`, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
             },
             "firefox_android": "mirror",
             "ie": {
@@ -1057,7 +1057,7 @@
             },
             "firefox": {
               "version_added": "1",
-              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of <code>https://z.com/x?a=true&amp;b=false</code>, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
+              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of `https://z.com/x?a=true&amp;b=false`, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
             },
             "firefox_android": "mirror",
             "ie": {

api/HTMLAreaElement.json

@@ -470,7 +470,7 @@
             },
             "firefox": {
               "version_added": "1",
-              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of <code>https://z.com/x?a=true&amp;b=false</code>, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
+              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of `https://z.com/x?a=true&amp;b=false`, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
             },
             "firefox_android": "mirror",
             "ie": {
@@ -866,7 +866,7 @@
             },
             "firefox": {
               "version_added": "1",
-              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of <code>https://z.com/x?a=true&amp;b=false</code>, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
+              "notes": "Before Firefox 53, the <code>pathname</code> and <code>search</code> <code>HTMLHyperlinkElementUtils</code> properties returned the wrong parts of the URL. For example, for a URL of `https://z.com/x?a=true&amp;b=false`, <code>pathname</code> would return <code>'/x?a=true&amp;b=false'</code> and <code>search</code> would return '', rather than <code>'/x'</code> and <code>'?a=true&amp;b=false'</code> respectively. This has now been fixed."
             },
             "firefox_android": "mirror",
             "ie": {

api/HTMLInputElement.json

@@ -1782,7 +1782,7 @@
           "support": {
             "chrome": {
               "version_added": false,
-              "notes": "A <code>selectionchange</code> event is fired on <code>Document</code>, see <a href='https://developer.mozilla.org/docs/Web/API/Document/selectionchange_event'><code>Document</code>'s <code>selectionchange</code> event</a>. See <a href='https://crbug.com/40840956'>bug 40840956</a> for firing the event on <code>&lt;input&gt;</code> elements."
+              "notes": "A <code>selectionchange</code> event is fired on <code>Document</code>, see [`Document`'s `selectionchange` event](https://developer.mozilla.org/docs/Web/API/Document/selectionchange_event). See <a href='https://crbug.com/1327098'>bug 1327098</a> for firing the event on <code>&lt;input&gt;</code> elements."
             },
             "chrome_android": "mirror",
             "edge": "mirror",

api/HTMLTextAreaElement.json

@@ -855,7 +855,7 @@
           "support": {
             "chrome": {
               "version_added": false,
-              "notes": "A <code>selectionchange</code> event is fired on <code>Document</code>, see <a href='https://developer.mozilla.org/docs/Web/API/Document/selectionchange_event'><code>Document</code>'s <code>selectionchange</code> event</a>. See <a href='https://crbug.com/40840956'>bug 40840956</a> for firing the event on <code>&lt;textarea&gt;</code> elements."
+              "notes": "A <code>selectionchange</code> event is fired on <code>Document</code>, see [`Document`'s `selectionchange` event](https://developer.mozilla.org/docs/Web/API/Document/selectionchange_event). See <a href='https://crbug.com/1327098'>bug 1327098</a> for firing the event on <code>&lt;textarea&gt;</code> elements."
             },
             "chrome_android": "mirror",
             "edge": "mirror",

css/properties/flex.json

@@ -34,7 +34,7 @@
                 "notes": [
                   "Since Firefox 28, multi-line flexbox is supported.",
                   "Before Firefox 32, Firefox wasn't able to animate values starting or stopping at <code>0</code>.",
-                  "Until Firefox 61, flex items that are sized according to their content are sized using <a href='https://drafts.csswg.org/css-sizing-3/#column-sizing'><code>fit-content</code>, not <code>max-content</code></a>."
+                  "Until Firefox 61, flex items that are sized according to their content are sized using <a href='https://drafts.csswg.org/css-sizing-3/#column-sizing'>`fit-content`, not `max-content`</a>."
                 ]
               },
               {

css/properties/hyphens.json

@@ -428,7 +428,7 @@
         },
         "language_bosnian": {
           "__compat": {
-            "description": "Hyphenation dictionary for Bosnian, Serbian, and Serbo-Croatian (sh, sh-*, sr, sr-*, bs, bs-*)",
+            "description": "Hyphenation dictionary for Bosnian, Serbian, and Serbo-Croatian (sh, sh-\\*, sr, sr-\\*, bs, bs-\\*)",
             "tags": [
               "web-features:hyphens"
             ],
@@ -1768,7 +1768,7 @@
         },
         "language_norwegian_nn": {
           "__compat": {
-            "description": "Hyphenation dictionary for Norwegian (Nynorsk) (nn, nn-*)",
+            "description": "Hyphenation dictionary for Norwegian (Nynorsk) (nn, nn-\\*)",
             "tags": [
               "web-features:hyphens"
             ],
@@ -1807,7 +1807,7 @@
         },
         "language_norwegian_no": {
           "__compat": {
-            "description": "Hyphenation dictionary for Norwegian (Bokmål) (no, no-*, nb, nb-*)",
+            "description": "Hyphenation dictionary for Norwegian (Bokmål) (no, no-\\*, nb, nb-\\*)",
             "tags": [
               "web-features:hyphens"
             ],

javascript/builtins/RegExp.json

@@ -775,7 +775,7 @@
         },
         "leftContext": {
           "__compat": {
-            "description": "<code>RegExp.leftContext</code> (<code>$`</code>)",
+            "description": "`RegExp.leftContext` (`$\\``)",
             "mdn_url": "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp/leftContext",
             "spec_url": "https://github.com/tc39/proposal-regexp-legacy-features/#additional-properties-of-the-regexp-constructor",
             "support": {

lint/linter/test-descriptions.ts

@@ -150,7 +150,7 @@ export default {
 
     for (const error of errors) {
       if (typeof error === 'string') {
-        logger.error(chalk`Description → ${error}`);
+        logger.error(chalk`{red ${error}}`);
       } else {
         logger.error(
           chalk`{red Incorrect ${error.ruleName} description for {bold ${error.path}}

lint/linter/test-notes.ts

@@ -3,6 +3,7 @@
 
 import chalk from 'chalk-template';
 import HTMLParser from '@desertnet/html-parser';
+import { marked } from 'marked';
 
 import { Linter, Logger, LinterData, VALID_ELEMENTS } from '../utils.js';
 import {
@@ -68,11 +69,12 @@ const testNode = (node): string[] => {
  */
 export const validateHTML = (string: string): string[] => {
   const errors: string[] = [];
-  const htmlErrors = HTMLParser.validate(string);
+  const html = marked.parseInline(string);
+  const htmlErrors = HTMLParser.validate(html);
 
   if (htmlErrors.length === 0) {
     // If HTML is valid, ensure we're only using valid elements
-    errors.push(...testNode(parser.parse(string)));
+    errors.push(...testNode(parser.parse(html)));
   } else {
     errors.push(
       chalk`Invalid HTML: ${htmlErrors.map((x) => x._message).join(', ')}`,