rumdl 0.1.51

A fast Markdown linter written in Rust (Ru(st) MarkDown Linter)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# MD069 - No duplicate list markers

Aliases: `no-duplicate-list-markers`

## What this rule does

Detects duplicate list markers that typically occur from copy-paste with editor auto-list-continuation, such as `- - text` instead of `- text`.

## Why this matters

- **Unintended nesting**: CommonMark parses `- - text` as a nested list, which is almost never the intended behavior
- **Visual confusion**: The extra marker clutters the document and creates unexpected formatting
- **Copy-paste artifacts**: This pattern commonly occurs when copying list items while editors auto-continue lists
- **Easy to overlook**: The duplicate marker blends in and can be missed during review

## Examples

### ✅ Correct

```markdown
- First item
- Second item
- Third item
```

### ❌ Incorrect

<!-- rumdl-disable MD069 -->

```markdown
- - First item (accidental duplicate)
* * Second item
- * Mixed markers
```

<!-- rumdl-enable MD069 -->

### 🔧 Fixed

```markdown
- First item
* Second item
* Mixed markers
```

## How this happens

This pattern typically occurs when:

1. **Copy-paste in editors**: You copy a list item, move to the next line (where the editor auto-inserts a list marker), then paste. Result: two markers.

2. **Double keystroke**: Accidentally pressing the marker key twice.

3. **Merge conflicts**: Git merge artifacts can create duplicate markers.

## Configuration

This rule has no configuration options.

## Automatic fixes

This rule automatically removes the first list marker, keeping the second one. For example:

- `- - text` becomes `- text`
- `* * text` becomes `* text`
- `- * text` becomes `* text` (keeps the second marker)

Indentation is preserved during the fix.

## What this rule does NOT flag

- `- --flag` - CLI flags (the second `-` is not followed by a space)
- `* *emphasis*` - Emphasis markers (the second `*` starts emphasis, not a list)
- `- **bold**` - Bold text starting a list item
- Properly indented nested lists - these are intentional

## Learn more

- [CommonMark list specification](https://spec.commonmark.org/0.31.2/#lists) - How lists are parsed
- [Nested lists](https://www.markdownguide.org/basic-syntax/#nested-lists) - How to create intentional nested lists

## Related rules

- [MD004](md004.md) - Consistent unordered list style
- [MD007](md007.md) - Unordered list indentation
- [MD030](md030.md) - Spaces after list markers