rumdl 0.0.91__tar.gz → 0.0.93__tar.gz

{rumdl-0.0.91 → rumdl-0.0.93}/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.93] - 2025-07-03
+
+## [0.0.92] - 2025-07-02
+
+### Fixed
+
+- MD036: Align with markdownlint behavior - emphasis ending with punctuation (e.g., `**Note:**`) is no longer flagged
+
 ## [0.0.91] - 2025-07-02
 
 ## [0.0.90] - 2025-07-01
@@ -14,6 +22,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.89] - 2025-07-01
 
 ### Added
+
 - Comprehensive unit test coverage for all 54 linting rules (~742 new tests)
 - Unit tests for LSP server functionality
 - Unit tests for all 11 output formatters
@@ -21,6 +30,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Test coverage improved from 75.4% to 77.1%
 
 ### Fixed
+
 - MD005: Fixed blockquote handling to correctly ignore intentional separations
 - MD054: Fixed overlapping match detection for link/image styles
 - Strong style utility module refactored to remove unused code
@@ -29,12 +39,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - MD013: Fixed line length calculation to intelligently handle URLs in non-strict mode
 
 ### Improved
+
 - Test infrastructure now includes both unit and integration tests
 - Better test organization with inline unit tests in implementation files
 
 ## [0.0.88] - 2025-06-28
 
 ### Added
+
 - 11 new output formatters for enhanced compatibility:
   - `grouped` - Groups violations by file
   - `pylint` - Pylint-compatible format
@@ -49,14 +61,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `text` - Default human-readable format with colors
 
 ### Changed
+
 - **BREAKING**: Upgraded to Rust 2024 edition (requires Rust 1.87.0+)
 - Improved code quality by fixing all 283 clippy warnings
 
 ### Fixed
+
 - Config `output_format` field now properly merges from configuration files
 - Pylint formatter now outputs correct `CMD` codes instead of generic `C` codes
 
 ### Optimized
+
 - Removed unused dependencies (`glob`, `walkdir`)
 - Reduced binary size with aggressive compilation flags (LTO, strip, opt-level=z)
 - Improved performance through better regex compilation and caching
@@ -70,12 +85,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.84] - 2025-06-10
 
 ### Added
+
 - Type-safe serde-based configuration system for all 24 configurable rules
 - Dedicated config modules for each rule with compile-time validation
 - Full IDE support with autocomplete for configuration options
 - Centralized utilities for common parsing patterns
 
 ### Changed
+
 - **BREAKING**: Internal configuration structure refactored (external API unchanged)
 - Migrated all rules from manual TOML parsing to serde deserialization
 - Improved performance through centralized parsing for:
@@ -87,9 +104,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - ~40% reduction in configuration boilerplate code
 
 ### Fixed
+
 - MD030: Correct handling of tab characters in list items
 
 ### Performance
+
 - Significant performance improvements across multiple rules through:
   - Centralized regex compilation and caching
   - Reduced redundant parsing operations
@@ -99,19 +118,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.83] - 2025-06-07
 
 ### Fixed
+
 - Various bug fixes and performance improvements
 
 ## [0.0.82] - 2025-06-06
 
 ### Fixed
+
 - Various bug fixes and stability improvements
 
 ## [0.0.81] - 2025-06-04
 
 ### Added
+
 - Initial implementation of remaining rules for markdownlint parity
 
-[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.91...HEAD
+[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.93...HEAD
+[0.0.93]: https://github.com/rvben/rumdl/compare/v0.0.92...v0.0.93
+[0.0.92]: https://github.com/rvben/rumdl/compare/v0.0.91...v0.0.92
 [0.0.91]: https://github.com/rvben/rumdl/compare/v0.0.90...v0.0.91
 [0.0.90]: https://github.com/rvben/rumdl/compare/v0.0.89...v0.0.90
 [0.0.89]: https://github.com/rvben/rumdl/compare/v0.0.88...v0.0.89
@@ -122,4 +146,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [0.0.84]: https://github.com/rvben/rumdl/compare/v0.0.83...v0.0.84
 [0.0.83]: https://github.com/rvben/rumdl/compare/v0.0.82...v0.0.83
 [0.0.82]: https://github.com/rvben/rumdl/compare/v0.0.81...v0.0.82
-[0.0.81]: https://github.com/rvben/rumdl/releases/tag/v0.0.81
+[0.0.81]: https://github.com/rvben/rumdl/releases/tag/v0.0.81

{rumdl-0.0.91 → rumdl-0.0.93}/Cargo.lock

@@ -848,6 +848,17 @@ version = "2.0.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f4c7245a08504955605670dbf141fceab975f15ca21570696aebe9d2e71576bd"
 
+[[package]]
+name = "io-uring"
+version = "0.7.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b86e202f00093dcba4275d4636b93ef9dd75d025ae560d2521b45ea28ab49013"
+dependencies = [
+ "bitflags 2.9.1",
+ "cfg-if",
+ "libc",
+]
+
 [[package]]
 name = "is-terminal"
 version = "0.4.16"
@@ -1454,7 +1465,7 @@ checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
 
 [[package]]
 name = "rumdl"
-version = "0.0.91"
+version = "0.0.93"
 dependencies = [
  "anyhow",
  "assert_cmd",
@@ -1785,17 +1796,19 @@ checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
 
 [[package]]
 name = "tokio"
-version = "1.45.1"
+version = "1.46.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75ef51a33ef1da925cea3e4eb122833cb377c61439ca401b770f54902b806779"
+checksum = "1140bb80481756a8cbe10541f37433b459c5aa1e727b4c020fbfebdc25bf3ec4"
 dependencies = [
  "backtrace",
  "bytes",
+ "io-uring",
  "libc",
  "mio",
  "parking_lot",
  "pin-project-lite",
  "signal-hook-registry",
+ "slab",
  "socket2",
  "tokio-macros",
  "windows-sys 0.52.0",

{rumdl-0.0.91 → rumdl-0.0.93}/Cargo.toml

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

{rumdl-0.0.91 → rumdl-0.0.93}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rumdl
-Version: 0.0.91
+Version: 0.0.93
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -48,41 +48,6 @@ Project-URL: Repository, https://github.com/rvben/rumdl.git
 
 </div>
 
-## Table of Contents
-
-- [rumdl - A high-performance Markdown linter, written in Rust](#rumdl---a-high-performance-markdown-linter-written-in-rust)
-  - [A modern Markdown linter and formatter, built for speed with Rust](#a-modern-markdown-linter-and-formatter-built-for-speed-with-rust)
-  - [Table of Contents](#table-of-contents)
-  - [Quick Start](#quick-start)
-  - [Overview](#overview)
-  - [Performance](#performance)
-  - [Installation](#installation)
-    - [Using Cargo (Rust)](#using-cargo-rust)
-    - [Using pip (Python)](#using-pip-python)
-    - [Download binary](#download-binary)
-    - [VS Code Extension](#vs-code-extension)
-  - [Usage](#usage)
-  - [Pre-commit Integration](#pre-commit-integration)
-  - [Rules](#rules)
-  - [Command-line Interface](#command-line-interface)
-    - [Commands](#commands)
-    - [Usage Examples](#usage-examples)
-  - [Configuration](#configuration)
-    - [Configuration File Example](#configuration-file-example)
-    - [Initializing Configuration](#initializing-configuration)
-    - [Configuration in pyproject.toml](#configuration-in-pyprojecttoml)
-    - [Configuration Output](#configuration-output)
-      - [Effective Configuration (`rumdl config`)](#effective-configuration-rumdl-config)
-      - [Example output](#example-output)
-    - [Defaults Only (`rumdl config --defaults`)](#defaults-only-rumdl-config---defaults)
-  - [Output Style](#output-style)
-    - [Output Format](#output-format)
-  - [Development](#development)
-    - [Prerequisites](#prerequisites)
-    - [Building](#building)
-    - [Testing](#testing)
-  - [License](#license)
-
 ## Quick Start
 
 ```bash
@@ -101,7 +66,11 @@ rumdl init
 
 ## Overview
 
-rumdl is a high-performance Markdown linter and fixer that helps ensure consistency and best practices in your Markdown files. It offers:
+rumdl is a high-performance Markdown linter and fixer 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.
+
+It offers:
 
 - ⚡️ **Built for speed** with Rust - significantly faster than alternatives
 - 🔍 **54 lint rules** covering common Markdown issues
@@ -113,13 +82,37 @@ rumdl is a high-performance Markdown linter and fixer that helps ensure consiste
 - 📏 **Modern CLI** with detailed error reporting
 - 🔄 **CI/CD friendly** with non-zero exit code on errors
 
-## Performance
-
-rumdl is designed for speed and efficiency:
-
-![Performance Comparison](assets/performance_overview.png)
+## Table of Contents
 
-rumdl is **4.3x faster** on average than markdownlint for typical markdown files, with performance improvements ranging from 3.4x to 5.4x depending on project size.
+- [Quick Start](#quick-start)
+- [Overview](#overview)
+- [Installation](#installation)
+  - [Using Cargo (Rust)](#using-cargo-rust)
+  - [Using pip (Python)](#using-pip-python)
+  - [Using uv](#using-uv)
+  - [Download binary](#download-binary)
+  - [VS Code Extension](#vs-code-extension)
+- [Usage](#usage)
+- [Pre-commit Integration](#pre-commit-integration)
+- [Rules](#rules)
+- [Command-line Interface](#command-line-interface)
+  - [Commands](#commands)
+  - [Usage Examples](#usage-examples)
+- [Configuration](#configuration)
+  - [Configuration File Example](#configuration-file-example)
+  - [Initializing Configuration](#initializing-configuration)
+  - [Configuration in pyproject.toml](#configuration-in-pyproject-toml)
+  - [Configuration Output](#configuration-output)
+    - [Effective Configuration (`rumdl config`)](#effective-configuration-rumdl-config)
+    - [Example output](#example-output)
+  - [Defaults Only (`rumdl config --defaults`)](#defaults-only-rumdl-config-defaults)
+- [Output Style](#output-style)
+  - [Output Format](#output-format)
+- [Development](#development)
+  - [Prerequisites](#prerequisites)
+  - [Building](#building)
+  - [Testing](#testing)
+- [License](#license)
 
 ## Installation
 
@@ -137,6 +130,18 @@ cargo install rumdl
 pip install rumdl
 ```
 
+### Using uv
+
+For faster installation and better dependency management with [uv](https://github.com/astral-sh/uv):
+
+```bash
+# Install directly
+uv tool install rumdl
+
+# Or run without installing
+uv tool run rumdl check .
+```
+
 ### Download binary
 
 ```bash
@@ -164,6 +169,7 @@ rumdl vscode --force
 ```
 
 The extension provides:
+
 - 🔍 Real-time linting as you type
 - 💡 Quick fixes for common issues
 - 🎨 Code formatting on save
@@ -275,9 +281,11 @@ rumdl <command> [options] [file or directory...]
 Lint Markdown files and print warnings/errors (main subcommand)
 
 **Arguments:**
+
 - `[PATHS...]`: Files or directories to lint. If provided, these paths take precedence over include patterns
 
 **Options:**
+
 - `-f, --fix`: Automatically fix issues where possible
 - `-l, --list-rules`: List all available rules
 - `-d, --disable <rules>`: Disable specific rules (comma-separated)
@@ -297,6 +305,7 @@ Lint Markdown files and print warnings/errors (main subcommand)
 Create a default configuration file in the current directory
 
 **Options:**
+
 - `--pyproject`: Generate configuration for `pyproject.toml` instead of `.rumdl.toml`
 
 #### `import <FILE> [OPTIONS]`
@@ -304,9 +313,11 @@ Create a default configuration file in the current directory
 Import and convert markdownlint configuration files to rumdl format
 
 **Arguments:**
+
 - `<FILE>`: Path to markdownlint config file (JSON/YAML)
 
 **Options:**
+
 - `-o, --output <path>`: Output file path (default: `.rumdl.toml`)
 - `--format <format>`: Output format: `toml` or `json` (default: `toml`)
 - `--dry-run`: Show converted config without writing to file
@@ -316,6 +327,7 @@ Import and convert markdownlint configuration files to rumdl format
 Show information about a rule or list all rules
 
 **Arguments:**
+
 - `[rule]`: Rule name or ID (optional). If provided, shows details for that rule. If omitted, lists all available rules
 
 #### `config [OPTIONS] [COMMAND]`
@@ -323,10 +335,12 @@ Show information about a rule or list all rules
 Show configuration or query a specific key
 
 **Options:**
+
 - `--defaults`: Show only the default configuration values
 - `--output <format>`: Output format (e.g. `toml`, `json`)
 
 **Subcommands:**
+
 - `get <key>`: Query a specific config key (e.g. `global.exclude` or `MD013.line_length`)
 - `file`: Show the absolute path of the configuration file that was loaded
 
@@ -335,6 +349,7 @@ Show configuration or query a specific key
 Start the Language Server Protocol server for editor integration
 
 **Options:**
+
 - `--port <PORT>`: TCP port to listen on (for debugging)
 - `--stdio`: Use stdio for communication (default)
 - `-v, --verbose`: Enable verbose logging
@@ -344,6 +359,7 @@ Start the Language Server Protocol server for editor integration
 Install the rumdl VS Code extension
 
 **Options:**
+
 - `--force`: Force reinstall even if already installed
 - `--status`: Show installation status without installing
 
@@ -431,6 +447,7 @@ rumdl can be configured in several ways:
 rumdl provides seamless compatibility with existing markdownlint configurations:
 
 **Automatic Discovery**: rumdl automatically detects and loads markdownlint config files:
+
 - `.markdownlint.json` / `.markdownlint.jsonc`
 - `.markdownlint.yaml` / `.markdownlint.yml`
 - `markdownlint.json` / `markdownlint.yaml`

{rumdl-0.0.91 → rumdl-0.0.93}/README.md

@@ -17,41 +17,6 @@
 
 </div>
 
-## Table of Contents
-
-- [rumdl - A high-performance Markdown linter, written in Rust](#rumdl---a-high-performance-markdown-linter-written-in-rust)
-  - [A modern Markdown linter and formatter, built for speed with Rust](#a-modern-markdown-linter-and-formatter-built-for-speed-with-rust)
-  - [Table of Contents](#table-of-contents)
-  - [Quick Start](#quick-start)
-  - [Overview](#overview)
-  - [Performance](#performance)
-  - [Installation](#installation)
-    - [Using Cargo (Rust)](#using-cargo-rust)
-    - [Using pip (Python)](#using-pip-python)
-    - [Download binary](#download-binary)
-    - [VS Code Extension](#vs-code-extension)
-  - [Usage](#usage)
-  - [Pre-commit Integration](#pre-commit-integration)
-  - [Rules](#rules)
-  - [Command-line Interface](#command-line-interface)
-    - [Commands](#commands)
-    - [Usage Examples](#usage-examples)
-  - [Configuration](#configuration)
-    - [Configuration File Example](#configuration-file-example)
-    - [Initializing Configuration](#initializing-configuration)
-    - [Configuration in pyproject.toml](#configuration-in-pyprojecttoml)
-    - [Configuration Output](#configuration-output)
-      - [Effective Configuration (`rumdl config`)](#effective-configuration-rumdl-config)
-      - [Example output](#example-output)
-    - [Defaults Only (`rumdl config --defaults`)](#defaults-only-rumdl-config---defaults)
-  - [Output Style](#output-style)
-    - [Output Format](#output-format)
-  - [Development](#development)
-    - [Prerequisites](#prerequisites)
-    - [Building](#building)
-    - [Testing](#testing)
-  - [License](#license)
-
 ## Quick Start
 
 ```bash
@@ -70,7 +35,11 @@ rumdl init
 
 ## Overview
 
-rumdl is a high-performance Markdown linter and fixer that helps ensure consistency and best practices in your Markdown files. It offers:
+rumdl is a high-performance Markdown linter and fixer 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.
+
+It offers:
 
 - ⚡️ **Built for speed** with Rust - significantly faster than alternatives
 - 🔍 **54 lint rules** covering common Markdown issues
@@ -82,13 +51,37 @@ rumdl is a high-performance Markdown linter and fixer that helps ensure consiste
 - 📏 **Modern CLI** with detailed error reporting
 - 🔄 **CI/CD friendly** with non-zero exit code on errors
 
-## Performance
-
-rumdl is designed for speed and efficiency:
-
-![Performance Comparison](assets/performance_overview.png)
+## Table of Contents
 
-rumdl is **4.3x faster** on average than markdownlint for typical markdown files, with performance improvements ranging from 3.4x to 5.4x depending on project size.
+- [Quick Start](#quick-start)
+- [Overview](#overview)
+- [Installation](#installation)
+  - [Using Cargo (Rust)](#using-cargo-rust)
+  - [Using pip (Python)](#using-pip-python)
+  - [Using uv](#using-uv)
+  - [Download binary](#download-binary)
+  - [VS Code Extension](#vs-code-extension)
+- [Usage](#usage)
+- [Pre-commit Integration](#pre-commit-integration)
+- [Rules](#rules)
+- [Command-line Interface](#command-line-interface)
+  - [Commands](#commands)
+  - [Usage Examples](#usage-examples)
+- [Configuration](#configuration)
+  - [Configuration File Example](#configuration-file-example)
+  - [Initializing Configuration](#initializing-configuration)
+  - [Configuration in pyproject.toml](#configuration-in-pyproject-toml)
+  - [Configuration Output](#configuration-output)
+    - [Effective Configuration (`rumdl config`)](#effective-configuration-rumdl-config)
+    - [Example output](#example-output)
+  - [Defaults Only (`rumdl config --defaults`)](#defaults-only-rumdl-config-defaults)
+- [Output Style](#output-style)
+  - [Output Format](#output-format)
+- [Development](#development)
+  - [Prerequisites](#prerequisites)
+  - [Building](#building)
+  - [Testing](#testing)
+- [License](#license)
 
 ## Installation
 
@@ -106,6 +99,18 @@ cargo install rumdl
 pip install rumdl
 ```
 
+### Using uv
+
+For faster installation and better dependency management with [uv](https://github.com/astral-sh/uv):
+
+```bash
+# Install directly
+uv tool install rumdl
+
+# Or run without installing
+uv tool run rumdl check .
+```
+
 ### Download binary
 
 ```bash
@@ -133,6 +138,7 @@ rumdl vscode --force
 ```
 
 The extension provides:
+
 - 🔍 Real-time linting as you type
 - 💡 Quick fixes for common issues
 - 🎨 Code formatting on save
@@ -244,9 +250,11 @@ rumdl <command> [options] [file or directory...]
 Lint Markdown files and print warnings/errors (main subcommand)
 
 **Arguments:**
+
 - `[PATHS...]`: Files or directories to lint. If provided, these paths take precedence over include patterns
 
 **Options:**
+
 - `-f, --fix`: Automatically fix issues where possible
 - `-l, --list-rules`: List all available rules
 - `-d, --disable <rules>`: Disable specific rules (comma-separated)
@@ -266,6 +274,7 @@ Lint Markdown files and print warnings/errors (main subcommand)
 Create a default configuration file in the current directory
 
 **Options:**
+
 - `--pyproject`: Generate configuration for `pyproject.toml` instead of `.rumdl.toml`
 
 #### `import <FILE> [OPTIONS]`
@@ -273,9 +282,11 @@ Create a default configuration file in the current directory
 Import and convert markdownlint configuration files to rumdl format
 
 **Arguments:**
+
 - `<FILE>`: Path to markdownlint config file (JSON/YAML)
 
 **Options:**
+
 - `-o, --output <path>`: Output file path (default: `.rumdl.toml`)
 - `--format <format>`: Output format: `toml` or `json` (default: `toml`)
 - `--dry-run`: Show converted config without writing to file
@@ -285,6 +296,7 @@ Import and convert markdownlint configuration files to rumdl format
 Show information about a rule or list all rules
 
 **Arguments:**
+
 - `[rule]`: Rule name or ID (optional). If provided, shows details for that rule. If omitted, lists all available rules
 
 #### `config [OPTIONS] [COMMAND]`
@@ -292,10 +304,12 @@ Show information about a rule or list all rules
 Show configuration or query a specific key
 
 **Options:**
+
 - `--defaults`: Show only the default configuration values
 - `--output <format>`: Output format (e.g. `toml`, `json`)
 
 **Subcommands:**
+
 - `get <key>`: Query a specific config key (e.g. `global.exclude` or `MD013.line_length`)
 - `file`: Show the absolute path of the configuration file that was loaded
 
@@ -304,6 +318,7 @@ Show configuration or query a specific key
 Start the Language Server Protocol server for editor integration
 
 **Options:**
+
 - `--port <PORT>`: TCP port to listen on (for debugging)
 - `--stdio`: Use stdio for communication (default)
 - `-v, --verbose`: Enable verbose logging
@@ -313,6 +328,7 @@ Start the Language Server Protocol server for editor integration
 Install the rumdl VS Code extension
 
 **Options:**
+
 - `--force`: Force reinstall even if already installed
 - `--status`: Show installation status without installing
 
@@ -400,6 +416,7 @@ rumdl can be configured in several ways:
 rumdl provides seamless compatibility with existing markdownlint configurations:
 
 **Automatic Discovery**: rumdl automatically detects and loads markdownlint config files:
+
 - `.markdownlint.json` / `.markdownlint.jsonc`
 - `.markdownlint.yaml` / `.markdownlint.yml`
 - `markdownlint.json` / `markdownlint.yaml`

{rumdl-0.0.91 → rumdl-0.0.93}/docs/global-settings.md

@@ -4,7 +4,8 @@ This document provides a comprehensive reference for rumdl's global configuratio
 
 ## Overview
 
-Global settings are configured in the `[global]` section of your configuration file (`.rumdl.toml` or `pyproject.toml`). These settings control file selection, rule enablement, and general linting behavior.
+Global settings are configured in the `[global]` section of your configuration file (`.rumdl.toml` or
+`pyproject.toml`). These settings control file selection, rule enablement, and general linting behavior.
 
 ## Quick Reference
 

{rumdl-0.0.91 → rumdl-0.0.93}/docs/md003.md

@@ -30,6 +30,32 @@ Second Level Heading
 ------------------
 ```
 
+### ✅ Correct (using setext_with_atx style)
+
+```markdown
+First Level Heading
+==================
+
+Second Level Heading
+------------------
+
+### Third Level Heading
+#### Fourth Level Heading
+```
+
+### ✅ Correct (using setext_with_atx_closed style)
+
+```markdown
+First Level Heading
+==================
+
+Second Level Heading
+------------------
+
+### Third Level Heading ###
+#### Fourth Level Heading ####
+```
+
 ### ❌ Incorrect (mixed styles)
 
 <!-- rumdl-disable MD003 -->
@@ -57,7 +83,7 @@ Second Level Heading
 
 ```yaml
 MD003:
-  style: "consistent"  # Options: "consistent", "atx", "atx_closed", "setext"
+  style: "consistent"  # Options: "consistent", "atx", "atx_closed", "setext", "setext_with_atx", "setext_with_atx_closed"
 ```
 
 ### Style options explained
@@ -66,6 +92,8 @@ MD003:
 - `"atx"`: Use # symbols (`# Heading`)
 - `"atx_closed"`: Use # symbols at both ends (`# Heading #`)
 - `"setext"`: Use underlines (equals for level 1, dashes for level 2)
+- `"setext_with_atx"`: Use underlines for level 1-2, # symbols for level 3-6
+- `"setext_with_atx_closed"`: Use underlines for level 1-2, # symbols with closing # for level 3-6
 
 > **Note**: Underline style only works for level 1 and 2 headings. Level 3 and below must use # symbols.
 

{rumdl-0.0.91 → rumdl-0.0.93}/docs/md004.md

@@ -33,6 +33,19 @@ Ensures all unordered lists use the same marker (* or + or -) throughout your do
 - Item 3
 ```
 
+### ✅ Correct (using sublist style)
+
+```markdown
+* Item 1
+* Item 2
+  + Nested item 1
+  + Nested item 2
+    - Deep nested item 1
+    - Deep nested item 2
+      * Even deeper (cycles back to *)
+* Item 3
+```
+
 ### ❌ Incorrect
 
 ```markdown
@@ -57,7 +70,7 @@ Ensures all unordered lists use the same marker (* or + or -) throughout your do
 
 ```yaml
 MD004:
-  style: "consistent"  # Options: "consistent", "asterisk", "plus", "dash"
+  style: "consistent"  # Options: "consistent", "asterisk", "plus", "dash", "sublist"
 ```
 
 ### Style options
@@ -66,6 +79,7 @@ MD004:
 - `"asterisk"`: Always use * markers
 - `"plus"`: Always use + markers  
 - `"dash"`: Always use - markers
+- `"sublist"`: Each nesting level uses a different marker (cycles through *, +, -)
 
 ## Automatic fixes