build: 🔨 add rumdl Markdown formatter (#204)

# Description

This PR adds the formatter to pre-commit and the justfile with a config
file copied from
[template-python-package](seedcase-project/template-python-package#239)

Needs a thorough review.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Luke W. Johnston <lwjohnst86@users.noreply.github.com>
Co-authored-by: Luke W. Johnston <lwjohnst@gmail.com>

Author: 3 people

.Rbuildignore

@@ -22,5 +22,6 @@
 ^\.editorconfig$
 ^\.pre-commit-config\.yaml$
 ^\.typos\.toml$
+^\.rumdl\.toml$
 ^_targets\.R$
 ^cran-comments\.md$

.pre-commit-config.yaml

@@ -28,3 +28,8 @@ repos:
     rev: v1.43.4
     hooks:
       - id: typos
+
+  - repo: https://github.com/rvben/rumdl-pre-commit
+    rev: v0.1.18
+    hooks:
+      - id: rumdl-fmt # Auto-format

.rumdl.toml

@@ -0,0 +1,31 @@
+[global]
+# 72 to match what we have currently been using
+line_length = 72
+flavor = "quarto"
+exclude = [
+    # Common directories to exclude
+    ".github",
+    # This is auto-generated from the qmd version
+    "**/README.md",
+    # This has it's own structure
+    "**/LICENSE.md",
+    "**/cran-comments.md"
+]
+
+# List style: `-`
+[MD004]
+style = "dash"
+
+# Wrap list items
+[MD032]
+allow-lazy-continuation = false
+
+# Reflow text
+[MD013]
+reflow = true
+reflow-mode = "normalize"
+
+# Fix tables and their separator row
+[MD060]
+enabled = true
+style = "aligned-no-space"

.vscode/extensions.json

@@ -5,7 +5,8 @@
 		"vivaxy.vscode-conventional-commits",
 		"pshaddel.conventional-branch",
 		"Posit.air-vscode",
-		"tekumara.typos-vscode"
+		"tekumara.typos-vscode",
+		"rvben.rumdl"
 	],
 	"unwantedRecommendations": []
 }

.vscode/settings.json

@@ -3,8 +3,6 @@
   "editor.tabSize": 2,
   "editor.wordWrap": "off",
   "git.autofetch": false,
-  "quarto.visualEditor.markdownWrap": "column",
-  "quarto.visualEditor.markdownWrapColumn": 72,
   "editor.tabCompletion": "on",
   "editor.snippetSuggestions": "inline",
   "conventional-branch.type": [

CODE_OF_CONDUCT.md

@@ -17,24 +17,24 @@ welcoming, diverse, inclusive, and healthy community.
 Examples of behavior that contributes to a positive environment for our
 community include:
 
--   Demonstrating empathy and kindness toward other people
--   Being respectful of differing opinions, viewpoints, and experiences
--   Giving and gracefully accepting constructive feedback
--   Accepting responsibility and apologizing to those affected by our
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our
     mistakes, and learning from the experience
--   Focusing on what is best not just for us as individuals, but for the
+- Focusing on what is best not just for us as individuals, but for the
     overall community
 
 Examples of unacceptable behavior include:
 
--   The use of sexualized language or imagery, and sexual attention or
+- The use of sexualized language or imagery, and sexual attention or
     advances of any kind
--   Trolling, insulting or derogatory comments, and personal or
+- Trolling, insulting or derogatory comments, and personal or
     political attacks
--   Public or private harassment
--   Publishing others' private information, such as a physical or email
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
     address, without their explicit permission
--   Other conduct which could reasonably be considered inappropriate in
+- Other conduct which could reasonably be considered inappropriate in
     a professional setting
 
 ## Enforcement Responsibilities
@@ -119,13 +119,14 @@ within the community.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor
-Covenant](https://www.contributor-covenant.org), version 2.1, available
-at
+This Code of Conduct is adapted from the
+[Contributor Covenant](https://www.contributor-covenant.org), version
+2.1, available at
 <https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>.
 
-Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/inclusion).
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement
+ladder](https://github.com/mozilla/inclusion).
 
 For answers to common questions about this code of conduct, see the FAQ
 at <https://www.contributor-covenant.org/faq>. Translations are

CONTRIBUTING.md

@@ -45,13 +45,13 @@ a terminal so that the working directory is the root of this project
 just run-all
 ```
 
-When committing changes, please try to follow [Conventional
-Commits](https://decisions.seedcase-project.org/why-conventional-commits/)
+When committing changes, please try to follow
+[Conventional Commits](https://decisions.seedcase-project.org/why-conventional-commits/)
 as Git messages. Using this convention allows us to be able to
 automatically create a release based on the commit message by using
 [Commitizen](https://decisions.seedcase-project.org/why-semantic-release-with-commitizen/).
 If you don't use Conventional Commits when making a commit, we will
-revise the pull request title to follow that format, as we use [squash
-merges](https://git-scm.com/docs/git-merge) when merging pull requests,
-when merging pull requests, so all other commits in the pull request
-will be squashed into one commit.
+revise the pull request title to follow that format, as we use
+[squash merges](https://git-scm.com/docs/git-merge) when merging pull
+requests, when merging pull requests, so all other commits in the pull
+request will be squashed into one commit.

NEWS.md

@@ -1,11 +1,11 @@
 # Changelog
 
-Since we follow [Conventional
-Commits](https://decisions.seedcase-project.org/why-conventional-commits)
+Since we follow
+[Conventional Commits](https://decisions.seedcase-project.org/why-conventional-commits)
 when writing commit messages, we're able to automatically create formal
 "releases" of the website based on the commit messages. Releases in the
-context of websites are simply snapshots in time of the website
-content. We use
+context of websites are simply snapshots in time of the website content.
+We use
 [Commitizen](https://decisions.seedcase-project.org/why-semantic-release-with-commitizen)
 to be able to automatically create these releases, which uses
 [SemVar](https://semverdoc.org) as the version numbering scheme.
@@ -38,7 +38,8 @@ each release.
 
 ### Fix
 
-- 🐛 abort `use_targets_template()` if file name is not `_targets.R` (#181)
+- 🐛 abort `use_targets_template()` if file name is not `_targets.R`
+  (#181)
 
 ## 0.8.9 (2026-02-13)
 
@@ -88,7 +89,8 @@ each release.
 
 ### Refactor
 
-- ♻️ get register name internally in `convert_to_parquet` from `path` (#161)
+- ♻️ get register name internally in `convert_to_parquet` from `path`
+  (#161)
 
 ## 0.8.1 (2026-02-06)
 
@@ -118,7 +120,8 @@ each release.
 
 ### Fix
 
-- :bug: update `convert_*()` param name in template; `file_paths` -> `path` (#150)
+- :bug: update `convert_*()` param name in template; `file_paths` ->
+  `path` (#150)
 
 ## 0.7.6 (2026-02-05)
 
@@ -184,7 +187,8 @@ each release.
 
 ### Refactor
 
-- :adhesive_bandage: ensure `source_file` is character before Arrow schema creation (#120)
+- :adhesive_bandage: ensure `source_file` is character before Arrow
+  schema creation (#120)
 
 ## 0.6.1 (2026-01-25)
 
@@ -196,7 +200,8 @@ each release.
 
 ### Feat
 
-- ✨ read SAS files in chunks; lowercase column names; align Arrow schemas (#112)
+- ✨ read SAS files in chunks; lowercase column names; align Arrow
+  schemas (#112)
 
 ## 0.5.0 (2025-12-15)
 

cran-comments.md

@@ -2,4 +2,4 @@
 
 0 errors | 0 warnings | 1 note
 
-* This is a new release.
+- This is a new release.

justfile

@@ -2,7 +2,7 @@
     just --list --unsorted
 
 # Run all recipes
-run-all: clean install-deps document update-wordlist spell-check check-url-cran check-url-lychee style test build-website build-readme check install-package
+run-all: clean install-deps document update-wordlist spell-check check-url-cran check-url-lychee format-md style test build-website build-readme check install-package
 
 # Clean up auto-generated files
 clean:
@@ -90,3 +90,7 @@ preview-website:
 # List all TODO items in the repository
 list-todos:
   grep -R -n --exclude="justfile" --exclude-dir="docs/deps" --exclude="*.json" --exclude="*.html" "TODO" *
+
+# Format Markdown files
+format-md:
+  uvx rumdl fmt --silent