chore: update markdownlint config and rename mise.toml to dotfile

Migrate markdownlint to cli2 format with schema validation. Disable
MD024 for Keep a Changelog repeated headings and MD060 for mixed table
styles. Expand allowed HTML elements and code fence languages. Add
.markdownlintignore for generated/third-party directories. Rename
mise.toml to .mise.toml per dotfile convention.

Author: danielsreichenbach

.markdownlint-cli2.jsonc

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/main/schema/markdownlint-cli2-config-schema.json",
+  // Common directories to ignore (generated/third-party content)
+  "ignores": [".venv/**", "node_modules/**", "vendor/**", "target/**"]
+}

.markdownlint.jsonc

@@ -1,49 +1,60 @@
 {
+  "$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint/main/schema/markdownlint-config-schema.json",
   "default": true,
   "MD003": {
-    "style": "atx"
+    "style": "atx",
   },
   "MD004": {
-    "style": "dash"
+    "style": "dash",
   },
   "MD007": {
-    "indent": 2
+    "indent": 2,
   },
   "MD013": {
     "line_length": 100,
     "code_blocks": false,
     "tables": false,
     "headings": false,
-    "strict": false
-  },
-  "MD024": {
-    "siblings_only": true
+    "strict": false,
   },
+  // MD024: Disabled to allow Keep a Changelog format in CHANGELOG.md
+  // which uses repeated section headings (Added, Changed, Fixed, Removed)
+  "MD024": false,
   "MD029": {
-    "style": "ordered"
+    "style": "ordered",
   },
   "MD033": {
     "allowed_elements": [
+      "a",
+      "br",
+      "details",
       "div",
+      "figcaption",
+      "figure",
+      "hostname",
       "img",
-      "br",
+      "picture",
+      "source",
+      "strong",
+      "sub",
+      "summary",
       "sup",
-      "sub"
-    ]
+    ],
   },
   "MD035": {
-    "style": "---"
+    "style": "---",
   },
   "MD040": {
     "allowed_languages": [
       "bash",
       "c",
+      "cmake",
       "cpp",
       "csharp",
-      "cmake",
       "diff",
       "dockerfile",
       "ebnf",
+      "ini",
       "glsl",
       "hcl",
       "json",
@@ -62,11 +73,14 @@
       "typescript",
       "wgsl",
       "xml",
-      "yaml"
+      "yaml",
     ],
-    "language_only": false
+    "language_only": false,
   },
   "MD046": {
-    "style": "fenced"
-  }
+    "style": "fenced",
+  },
+  // MD060: Table column style - disabled because existing tables use mixed
+  // styles (some compact, some expanded). Tables are readable as-is.
+  "MD060": false,
 }

.markdownlintignore

@@ -0,0 +1,12 @@
+# Third-party dependencies
+.venv
+node_modules
+vendor
+target
+
+# Standard license text
+LICENSE.md
+
+# YAML files (not Markdown)
+.github/workflows/*.yml
+.github/workflows/*.yaml

mise.toml .mise.tomlmise.toml renamed to .mise.toml

@@ -17,6 +17,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Updated markdownlint configuration: added `$schema`, disabled MD024 for
+  Keep a Changelog format, disabled MD060, expanded allowed HTML elements and
+  code fence languages
+- Added `.markdownlint-cli2.jsonc` config and `.markdownlintignore`
+- Renamed `mise.toml` to `.mise.toml` (dotfile convention)
 - Upgraded `glam` from 0.29 to 0.31
 - Upgraded `bitflags` from 2.9 to 2.10
 - Upgraded `ordered-float` from 5.0 to 5.1