rumdl 0.0.123__tar.gz → 0.0.125__tar.gz

{rumdl-0.0.123 → rumdl-0.0.125}/CHANGELOG.md

@@ -7,7 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.0.123] - 2025-08-21
+## [0.0.125] - 2025-08-22
+
+### Added
+- **CLI**: Added `--stdin-filename` flag for better stdin processing
+  - Specify filename when reading from stdin for better error messages
+  - Enables MD057 (relative link checking) to work correctly with stdin
+  - Provides proper filename context in all output formats
+  - Improves editor integration capabilities
+
+### Fixed
+- **CLI**: Fixed `rumdl fmt -` to output original content when no issues found
+  - Previously incorrectly output "No issues found in stdin" message
+  - Now correctly outputs the original content unchanged
+- **MD029**: Corrected list continuity detection and fix functionality
+  - Improved handling of sublists and indented content
+  - Better markdownlint compatibility
+
+### Changed
+- **Build**: Added mise version validation to pre-release checks
+  - Prevents CI failures from non-existent mise versions
+
+## [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
 
@@ -33,6 +71,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [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
@@ -52,6 +98,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
@@ -68,6 +117,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
@@ -95,17 +147,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
 
@@ -125,8 +188,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
@@ -396,7 +457,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.123...HEAD
+[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.125...HEAD
+[0.0.125]: https://github.com/rvben/rumdl/compare/v0.0.124...v0.0.125
+[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
@@ -410,10 +473,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.123 → rumdl-0.0.125}/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",
 ]
@@ -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",
 ]
@@ -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.123"
+version = "0.0.125"
 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",
@@ -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.123 → rumdl-0.0.125}/Cargo.toml

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

{rumdl-0.0.123 → rumdl-0.0.125}/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.123 → rumdl-0.0.125}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rumdl
-Version: 0.0.123
+Version: 0.0.125
 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,38 @@ 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
+
+# Provide filename context for better error messages (useful for editor integrations)
+cat README.md | rumdl check - --stdin-filename README.md
+```
+
+### 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 +373,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 +495,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 +552,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 +750,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

{rumdl-0.0.123 → rumdl-0.0.125}/README.md

@@ -26,8 +26,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
@@ -35,7 +36,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.
 
@@ -43,7 +44,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
@@ -66,6 +67,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)
@@ -73,6 +76,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)
@@ -184,8 +188,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
@@ -216,6 +220,38 @@ 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
+
+# Provide filename context for better error messages (useful for editor integrations)
+cat README.md | rumdl check - --stdin-filename README.md
+```
+
+### 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.
@@ -308,6 +344,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
@@ -399,8 +466,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
@@ -455,11 +523,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:
@@ -631,7 +721,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