rumdl 0.0.122__tar.gz → 0.0.124__tar.gz

{rumdl-0.0.122 → rumdl-0.0.124}/CHANGELOG.md

@@ -7,8 +7,57 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.124] - 2025-08-22
+
+### Added
+- **Formatting**: Added stdin/stdout formatting support (closes #59)
+  - `rumdl fmt` command for formatting markdown files (alias for `check --fix`)
+  - `--stdin` with `--fix` now outputs formatted content to stdout
+  - Support for `-` as stdin indicator (Unix convention: `rumdl fmt -`)
+  - Clear separation between linting (diagnostics to stderr) and formatting (content to stdout)
+  - Documentation updated with formatting examples
+
+### Fixed
+- **MD052**: Don't flag GitHub alerts as undefined references (closes #60)
+  - GitHub alert syntax (`[!NOTE]`, `[!TIP]`, `[!WARNING]`, `[!IMPORTANT]`, `[!CAUTION]`) no longer flagged
+  - Improved compatibility with GitHub-flavored markdown
+- **MD009**: Fixed heading trailing space removal
+  - Headings now have ALL trailing spaces removed (they serve no purpose in headings)
+- **CLI**: Fixed stdin diagnostics output in check mode
+  - Diagnostics now correctly output to stderr by default in check mode without `--fix`
+
+## [0.0.123] - 2025-08-21
+
+### Added
+- **MD013**: Comprehensive markdown pattern preservation during text reflow
+  - Preserves reference links, footnotes, math formulas, wiki links, and more
+  - Centralized regex patterns for better maintainability
+
+### Fixed
+- **CLI**: Correct unfixable rules status display and fix counts (closes #56)
+  - Rules marked as unfixable now show `[unfixable]` in yellow instead of `[fixed]`
+  - Fix count now correctly excludes unfixable rules (e.g., "3 of 6" instead of "6 of 6")
+  - Added FixCapability enum to Rule trait for compile-time safety
+- **MD013**: Preserve reference links during text reflow
+  - Reference-style links are now properly preserved when reflowing text
+  - Fixed indicator display to correctly show `[fixed]` when issues are resolved
+- **Tests**: Mark kramdown definition list doctest as text to fix test failures
+
+### Changed
+- **Internal**: Centralized markdown pattern regexes and extended reflow support
+  - Improved code organization and reduced duplication
+  - Better performance through shared regex compilation
+
 ## [0.0.122] - 2025-08-19
 
+### Added
+- **Configuration Discovery**: Automatic upward directory traversal to find configuration files (closes #58)
+  - Searches parent directories for `.rumdl.toml`, `rumdl.toml`, or `pyproject.toml` 
+  - Similar behavior to `git`, `ruff`, and `eslint`
+  - Stops at `.git` directory boundaries
+- **--isolated flag**: New flag to disable all configuration discovery (Ruff-compatible)
+  - Alias for `--no-config` for better ecosystem compatibility
+
 ## [0.0.121] - 2025-08-19
 
 ### Fixed
@@ -28,6 +77,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.0.120] - 2025-08-16
 
+### Performance
+- Incremental improvements to various rule implementations
+
 ## [0.0.119] - 2025-08-15
 
 ### Fixed
@@ -44,6 +96,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.0.118] - 2025-08-14
 
+### Performance
+- Incremental improvements to various rule implementations
+
 ## [0.0.117] - 2025-08-14
 
 ### Fixed
@@ -71,17 +126,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.0.115] - 2025-08-12
 
+### Fixed
+- Various bug fixes and improvements
+
 ## [0.0.114] - 2025-08-09
 
+### Fixed
+- Various bug fixes and improvements
+
 ## [0.0.113] - 2025-08-09
 
+### Fixed
+- Various bug fixes and improvements
+
 ## [0.0.112] - 2025-08-08
 
-## [0.0.110] - 2025-08-08
+### Fixed
+- Various bug fixes and improvements
 
 ## [0.0.110] - 2025-08-08
 
-## [0.0.107] - 2025-08-06
+### Changed
+- Various bug fixes and improvements
 
 ## [0.0.107] - 2025-08-06
 
@@ -101,8 +167,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.0.105] - 2025-08-05
 
-## [0.0.105] - 2025-08-05
-
 ### Fixed
 - MD029: Fixed list continuation detection to properly handle variable marker widths (fixes #16)
   - List items with double-digit markers (e.g., "10. ") now correctly require 4+ spaces for continuation
@@ -372,7 +436,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial implementation of remaining rules for markdownlint parity
 
-[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.122...HEAD
+[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.124...HEAD
+[0.0.124]: https://github.com/rvben/rumdl/compare/v0.0.123...v0.0.124
+[0.0.123]: https://github.com/rvben/rumdl/compare/v0.0.122...v0.0.123
 [0.0.122]: https://github.com/rvben/rumdl/compare/v0.0.121...v0.0.122
 [0.0.121]: https://github.com/rvben/rumdl/compare/v0.0.120...v0.0.121
 [0.0.120]: https://github.com/rvben/rumdl/compare/v0.0.119...v0.0.120
@@ -385,10 +451,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [0.0.113]: https://github.com/rvben/rumdl/compare/v0.0.112...v0.0.113
 [0.0.112]: https://github.com/rvben/rumdl/compare/v0.0.111...v0.0.112
 [0.0.110]: https://github.com/rvben/rumdl/compare/v0.0.109...v0.0.110
-[0.0.110]: https://github.com/rvben/rumdl/compare/v0.0.109...v0.0.110
 [0.0.107]: https://github.com/rvben/rumdl/compare/v0.0.106...v0.0.107
-[0.0.107]: https://github.com/rvben/rumdl/compare/v0.0.106...v0.0.107
-[0.0.105]: https://github.com/rvben/rumdl/compare/v0.0.104...v0.0.105
+[0.0.106]: https://github.com/rvben/rumdl/compare/v0.0.105...v0.0.106
 [0.0.105]: https://github.com/rvben/rumdl/compare/v0.0.104...v0.0.105
 [0.0.104]: https://github.com/rvben/rumdl/compare/v0.0.103...v0.0.104
 [0.0.102]: https://github.com/rvben/rumdl/compare/v0.0.101...v0.0.102

{rumdl-0.0.122 → rumdl-0.0.124}/Cargo.lock

@@ -185,9 +185,9 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bitflags"
-version = "2.9.2"
+version = "2.9.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6a65b545ab31d687cff52899d4890855fec459eb6afe0da6417b8a18da87aa29"
+checksum = "34efbcccd345379ca2868b2b2c9d3782e9cc58ba87bc7d79d5b53d9c9ae6f25d"
 
 [[package]]
 name = "bstr"
@@ -220,9 +220,9 @@ checksum = "37b2a672a2cb129a2e41c10b1224bb368f9f37a2b16b612598138befd7b37eb5"
 
 [[package]]
 name = "cc"
-version = "1.2.33"
+version = "1.2.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ee0f8803222ba5a7e2777dd72ca451868909b1ac410621b676adf07280e9b5f"
+checksum = "42bc4aea80032b7bf409b0bc7ccad88853858911b7713a8062fdc0623867bedc"
 dependencies = [
  "shlex",
 ]
@@ -530,9 +530,9 @@ checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
 
 [[package]]
 name = "form_urlencoded"
-version = "1.2.1"
+version = "1.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e13624c2627564efccf4934284bdd98cbaa14e79b0b5a141218e507b3a823456"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
 dependencies = [
  "percent-encoding",
 ]
@@ -806,9 +806,9 @@ dependencies = [
 
 [[package]]
 name = "idna"
-version = "1.0.3"
+version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "686f825264d630750a544639377bae737628043f20d38bbc029e8f29ea968a7e"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
 dependencies = [
  "idna_adapter",
  "smallvec",
@@ -843,9 +843,9 @@ dependencies = [
 
 [[package]]
 name = "indexmap"
-version = "2.10.0"
+version = "2.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fe4cd85333e22411419a0bcae1297d25e58c9443848b11dc6a86fefe8c78a661"
+checksum = "f2481980430f9f78649238835720ddccc57e52df14ffce1c6f37391d61b563e9"
 dependencies = [
  "equivalent",
  "hashbrown 0.15.5",
@@ -859,11 +859,11 @@ checksum = "f4c7245a08504955605670dbf141fceab975f15ca21570696aebe9d2e71576bd"
 
 [[package]]
 name = "io-uring"
-version = "0.7.9"
+version = "0.7.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d93587f37623a1a17d94ef2bc9ada592f5465fe7732084ab7beefabe5c77c0c4"
+checksum = "046fa2d4d00aea763528b4950358d0ead425372445dc8ff86312b3c69ff7727b"
 dependencies = [
- "bitflags 2.9.2",
+ "bitflags 2.9.3",
  "cfg-if",
  "libc",
 ]
@@ -1013,9 +1013,9 @@ checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0"
 
 [[package]]
 name = "memmap2"
-version = "0.9.7"
+version = "0.9.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "483758ad303d734cec05e5c12b41d7e93e6a6390c5e9dae6bdeb7c1259012d28"
+checksum = "843a98750cd611cc2965a8213b53b43e715f13c37a9e096c6408e69990961db7"
 dependencies = [
  "libc",
 ]
@@ -1126,9 +1126,9 @@ dependencies = [
 
 [[package]]
 name = "percent-encoding"
-version = "2.3.1"
+version = "2.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
 
 [[package]]
 name = "pin-project"
@@ -1280,7 +1280,7 @@ checksum = "6fcdab19deb5195a31cf7726a210015ff1496ba1464fd42cb4f537b8b01b471f"
 dependencies = [
  "bit-set",
  "bit-vec",
- "bitflags 2.9.2",
+ "bitflags 2.9.3",
  "lazy_static",
  "num-traits",
  "rand",
@@ -1298,7 +1298,7 @@ version = "0.12.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f86ba2052aebccc42cbbb3ed234b8b13ce76f75c3551a303cb2bcffcff12bb14"
 dependencies = [
- "bitflags 2.9.2",
+ "bitflags 2.9.3",
  "getopts",
  "memchr",
  "pulldown-cmark-escape",
@@ -1459,7 +1459,7 @@ version = "0.5.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5407465600fb0548f1442edf71dd20683c6ed326200ace4b1ef0763521bb3b77"
 dependencies = [
- "bitflags 2.9.2",
+ "bitflags 2.9.3",
 ]
 
 [[package]]
@@ -1493,7 +1493,7 @@ checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
 
 [[package]]
 name = "rumdl"
-version = "0.0.122"
+version = "0.0.124"
 dependencies = [
  "anyhow",
  "assert_cmd",
@@ -1555,7 +1555,7 @@ version = "1.0.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "11181fbabf243db407ef8df94a6ce0b2f9a733bd8be4ad02b4eda9602296cac8"
 dependencies = [
- "bitflags 2.9.2",
+ "bitflags 2.9.3",
  "errno",
  "libc",
  "linux-raw-sys",
@@ -1751,15 +1751,15 @@ checksum = "e502f78cdbb8ba4718f566c418c52bc729126ffd16baee5baa718cf25dd5a69a"
 
 [[package]]
 name = "tempfile"
-version = "3.20.0"
+version = "3.21.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e8a64e3985349f2441a1a9ef0b853f869006c3855f2cda6862a94d26ebb9d6a1"
+checksum = "15b61f8f20e3a6f7e0649d825294eaf317edce30f82cf6026e7e4cb9222a7d1e"
 dependencies = [
  "fastrand",
  "getrandom",
  "once_cell",
  "rustix",
- "windows-sys 0.59.0",
+ "windows-sys 0.60.2",
 ]
 
 [[package]]
@@ -1770,18 +1770,18 @@ checksum = "8f50febec83f5ee1df3015341d8bd429f2d1cc62bcba7ea2076759d315084683"
 
 [[package]]
 name = "thiserror"
-version = "2.0.15"
+version = "2.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "80d76d3f064b981389ecb4b6b7f45a0bf9fdac1d5b9204c7bd6714fecc302850"
+checksum = "3467d614147380f2e4e374161426ff399c91084acd2363eaf549172b3d5e60c0"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "2.0.15"
+version = "2.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "44d29feb33e986b6ea906bd9c3559a856983f92371b3eaa5e83782a351623de0"
+checksum = "6c5e1be1c48b9172ee610da68fd9cd2770e7a4056cb3fc98710ee6906f0c7960"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2080,9 +2080,9 @@ checksum = "673aac59facbab8a9007c7f6108d11f63b603f7cabff99fabf650fea5c32b861"
 
 [[package]]
 name = "url"
-version = "2.5.4"
+version = "2.5.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "32f8b686cadd1473f4bd0117a5d28d36b1ade384ea9b5069a1c40aefed7fda60"
+checksum = "137a3c834eaf7139b73688502f3f1141a0337c5d8e4d9b536f9b8c796e26a7c4"
 dependencies = [
  "form_urlencoded",
  "idna",
@@ -2206,11 +2206,11 @@ dependencies = [
 
 [[package]]
 name = "winapi-util"
-version = "0.1.9"
+version = "0.1.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf221c93e13a30d793f7645a0e7762c55d169dbb0a49671918a2319d289b10bb"
+checksum = "0978bf7171b3d90bac376700cb56d606feb40f251a475a5d6634613564460b22"
 dependencies = [
- "windows-sys 0.59.0",
+ "windows-sys 0.60.2",
 ]
 
 [[package]]
@@ -2421,9 +2421,9 @@ checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486"
 
 [[package]]
 name = "winnow"
-version = "0.7.12"
+version = "0.7.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3edebf492c8125044983378ecb5766203ad3b4c2f7a922bd7dd207f6d443e95"
+checksum = "21a0236b59786fed61e2a80582dd500fe61f18b5dca67a4a067d0bc9039339cf"
 dependencies = [
  "memchr",
 ]
@@ -2434,7 +2434,7 @@ version = "0.39.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6f42320e61fe2cfd34354ecb597f86f413484a798ba44a8ca1165c58d42da6c1"
 dependencies = [
- "bitflags 2.9.2",
+ "bitflags 2.9.3",
 ]
 
 [[package]]

{rumdl-0.0.122 → rumdl-0.0.124}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rumdl"
-version = "0.0.122"
+version = "0.0.124"
 edition = "2024"
 rust-version = "1.89.0"
 description = "A fast Markdown linter written in Rust (Ru(st) MarkDown Linter)"

{rumdl-0.0.122 → rumdl-0.0.124}/Makefile

@@ -334,7 +334,7 @@ update-rust-version:
 		cargo check || (echo "Warning: cargo check failed. You may need to fix compatibility issues."; exit 1); \
 	fi
 
-pre-release:
+prepare-release:
 	@echo "Preparing for release..."
 	@echo "===================="
 	@$(MAKE) update-rust-version
@@ -354,6 +354,6 @@ pre-release:
 	@echo "Please review changes and commit if satisfied."
 
 # Full release targets that include pre-release preparation
-release-major-full: pre-release version-major version-push
-release-minor-full: pre-release version-minor version-push
-release-patch-full: pre-release version-patch version-push
+release-major-full: prepare-release version-major version-push
+release-minor-full: prepare-release version-minor version-push
+release-patch-full: prepare-release version-patch version-push

{rumdl-0.0.122 → rumdl-0.0.124}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rumdl
-Version: 0.0.122
+Version: 0.0.124
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -55,8 +55,9 @@ cargo install rumdl
 # Lint Markdown files in the current directory
 rumdl check .
 
-# Automatically fix issues
-rumdl check --fix .
+# Format files (automatically fix issues)
+rumdl fmt .
+# Alternative: rumdl check --fix .
 
 # Create a default configuration file
 rumdl init
@@ -64,7 +65,7 @@ rumdl init
 
 ## Overview
 
-rumdl is a high-performance Markdown linter and fixer that helps ensure consistency and best practices
+rumdl is a high-performance Markdown linter and formatter that helps ensure consistency and best practices
 in your Markdown files. Inspired by [ruff](https://github.com/astral-sh/ruff)'s approach to Python linting,
 rumdl brings similar speed and developer experience improvements to the Markdown ecosystem.
 
@@ -72,7 +73,7 @@ It offers:
 
 - ⚡️ **Built for speed** with Rust - significantly faster than alternatives
 - 🔍 **54 lint rules** covering common Markdown issues
-- 🛠️ **Automatic fixing** with `--fix` for most rules
+- 🛠️ **Automatic formatting** with `--fix` for files and stdin/stdout
 - 📦 **Zero dependencies** - single binary with no runtime requirements
 - 🔧 **Highly configurable** with TOML-based config files
 - 🌐 **Multiple installation options** - Rust, Python, standalone binaries
@@ -95,6 +96,8 @@ It offers:
     - [Download binary](#download-binary)
     - [VS Code Extension](#vs-code-extension)
   - [Usage](#usage)
+    - [Stdin/Stdout Formatting](#stdinstdout-formatting)
+    - [Editor Integration](#editor-integration)
   - [Pre-commit Integration](#pre-commit-integration)
   - [CI/CD Integration](#cicd-integration)
     - [GitHub Actions](#github-actions)
@@ -102,6 +105,7 @@ It offers:
   - [Command-line Interface](#command-line-interface)
     - [Commands](#commands)
       - [`check [PATHS...]`](#check-paths)
+      - [`fmt [PATHS...]`](#fmt-paths)
       - [`init [OPTIONS]`](#init-options)
       - [`import <FILE> [OPTIONS]`](#import-file-options)
       - [`rule [<rule>]`](#rule-rule)
@@ -213,8 +217,8 @@ rumdl check README.md
 # Lint all Markdown files in current directory and subdirectories
 rumdl check .
 
-# Automatically fix issues
-rumdl check --fix README.md
+# Format a specific file
+rumdl fmt README.md
 
 # Create a default configuration file
 rumdl init
@@ -245,6 +249,35 @@ rumdl check --include "docs/**/*.md" --exclude "docs/temp,docs/drafts" .
 rumdl check --respect-gitignore=false .
 ```
 
+### Stdin/Stdout Formatting
+
+rumdl supports formatting via stdin/stdout, making it ideal for editor integrations and CI pipelines:
+
+```bash
+# Format content from stdin and output to stdout
+cat README.md | rumdl fmt - > README_formatted.md
+# Alternative: cat README.md | rumdl fmt --stdin > README_formatted.md
+
+# Use in a pipeline
+echo "# Title   " | rumdl fmt -
+# Output: # Title
+
+# Format clipboard content (macOS example)
+pbpaste | rumdl fmt - | pbcopy
+```
+
+### Editor Integration
+
+For editor integration, use stdin/stdout mode with the `--quiet` flag to suppress diagnostic messages:
+
+```bash
+# Format selection in editor (example for vim)
+:'<,'>!rumdl fmt - --quiet
+
+# Format entire buffer
+:%!rumdl fmt - --quiet
+```
+
 ## Pre-commit Integration
 
 You can use `rumdl` as a pre-commit hook to check and fix your Markdown files.
@@ -337,6 +370,37 @@ Lint Markdown files and print warnings/errors (main subcommand)
 - `-o, --output <format>`: Output format: `text` (default) or `json`
 - `--stdin`: Read from stdin instead of files
 
+#### `fmt [PATHS...]`
+
+Format Markdown files (alias for `check --fix`)
+
+**Arguments:**
+
+- `[PATHS...]`: Files or directories to format. If provided, these paths take precedence over include patterns
+
+**Options:**
+
+All the same options as `check` are available (except `--fix` which is always enabled), including:
+- `--stdin`: Format content from stdin and output to stdout
+- `-d, --disable <rules>`: Disable specific rules during formatting
+- `-e, --enable <rules>`: Format using only specific rules
+- `--exclude/--include`: Control which files to format
+- `-q, --quiet`: Suppress diagnostic output
+
+**Examples:**
+
+```bash
+# Format all Markdown files in current directory
+rumdl fmt
+
+# Format specific file
+rumdl fmt README.md
+
+# Format from stdin (using dash syntax)
+cat README.md | rumdl fmt - > formatted.md
+# Alternative: cat README.md | rumdl fmt --stdin > formatted.md
+```
+
 #### `init [OPTIONS]`
 
 Create a default configuration file in the current directory
@@ -428,8 +492,9 @@ This allows scripts and CI/CD systems to distinguish between "the tool found pro
 # Lint all Markdown files in the current directory
 rumdl check .
 
-# Automatically fix issues
-rumdl check --fix .
+# Format files (automatically fix issues)
+rumdl fmt .
+# Alternative: rumdl check --fix .
 
 # Create a default configuration file
 rumdl init
@@ -484,11 +549,33 @@ rumdl version
 
 rumdl can be configured in several ways:
 
-1. Using a `.rumdl.toml` file in your project directory
+1. Using a `.rumdl.toml` file in your project directory or parent directories
 2. Using the `[tool.rumdl]` section in your project's `pyproject.toml` file (for Python projects)
 3. Using command-line arguments
 4. **Automatic markdownlint compatibility**: rumdl automatically discovers and loads existing markdownlint config files (`.markdownlint.json`, `.markdownlint.yaml`, etc.)
 
+### Configuration Discovery
+
+rumdl automatically searches for configuration files by traversing up the directory tree from the current
+working directory, similar to tools like `git`, `ruff`, and `eslint`. This means you can run rumdl from any
+subdirectory of your project and it will find the configuration file at the project root.
+
+The search follows these rules:
+- Searches upward for `.rumdl.toml`, `rumdl.toml`, or `pyproject.toml` (with `[tool.rumdl]` section)
+- Stops at the first configuration file found
+- Stops searching when it encounters a `.git` directory (project boundary)
+- Maximum traversal depth of 100 directories
+
+To disable all configuration discovery and use only built-in defaults, use the `--isolated` flag:
+
+```bash
+# Use discovered configuration (default behavior)
+rumdl check .
+
+# Ignore all configuration files
+rumdl check --isolated .
+```
+
 ### Markdownlint Migration
 
 rumdl provides seamless compatibility with existing markdownlint configurations:
@@ -660,7 +747,7 @@ README.md:24:5: [MD037] Spaces inside emphasis markers: "* incorrect *" [*]
 README.md:42:3: [MD010] Hard tabs found, use spaces instead [*]
 
 Found 3 issues in 1 file (2 files checked)
-Run with `--fix` to automatically fix issues
+Run `rumdl fmt` to automatically fix issues
 ```
 
 ### Output Format