docs: bring back remark formatter (#14040)

* docs: format docs

* docs: Fix URLs in website documentation

* chore: bring back mdast formatter

* docs: format docs

* docs: remove heading id in jsx component

* docs: fix heading level

* chore: update remark formatter plugins

* chore: Update dependabot ignore list

.github/dependabot.yml

@@ -20,22 +20,23 @@ updates:
         versions: ['>=8.0.0']
       - dependency-name: rand-user-agent
         versions: ['>=2.0.1']
-      - dependency-name: remark
-        versions: ['>=14.0.0']
-      - dependency-name: remark-frontmatter
-        versions: ['>=4.0.0']
-      - dependency-name: remark-gfm
-        versions: ['>=2.0.0']
       - dependency-name: remark-parse
         versions: ['>=10.0.0']
       - dependency-name: remark-preset-prettier
         versions: ['>=1.0.0']
-      - dependency-name: remark-stringify
-        versions: ['>=10.0.0']
-      - dependency-name: string-width
-        versions: ['>=5.0.0']
       - dependency-name: unified
         versions: ['>=10.0.0']
+    # remark-custom-heading-id is not updated to
+    # the latest mdast/mdxast which is released from
+    # the second half of 2023
+      - dependency-name: remark
+        versions: ['>=15.0.0']
+      - dependency-name: remark-frontmatter
+        versions: ['>=5.0.0']
+      - dependency-name: remark-gfm
+        versions: ['>=4.0.0']
+      - dependency-name: remark-mdx
+        versions: ['>=3.0.0']
 
   - package-ecosystem: npm
     directory: '/website'

package.json

@@ -196,19 +196,24 @@
     "nock": "13.4.0",
     "nodemon": "3.0.2",
     "prettier": "3.1.1",
-    "remark": "13.0.0",
-    "remark-frontmatter": "3.0.0",
-    "remark-gfm": "1.0.0",
+    "remark": "14.0.3",
+    "remark-custom-heading-id": "1.0.1",
+    "remark-directive": "3.0.0",
+    "remark-frontmatter": "4.0.1",
+    "remark-gfm": "3.0.1",
+    "remark-mdx": "2.3.0",
     "remark-pangu": "2.2.0",
     "remark-parse": "9.0.0",
     "remark-preset-prettier": "0.5.1",
-    "remark-stringify": "9.0.1",
     "request-promise-native": "1.0.9",
     "staged-git-files": "1.3.0",
-    "string-width": "4.2.3",
+    "string-width": "7.0.0",
     "supertest": "6.3.3",
+    "to-vfile": "8.0.0",
     "tosource": "2.0.0-alpha.3",
-    "unified": "9.2.2"
+    "unified": "9.2.2",
+    "unist-util-visit": "4.1.2",
+    "unist-util-visit-parents": "5.1.3"
   },
   "engines": {
     "node": ">=16"