# MD033 - No HTML tags
Aliases: `no-inline-html`
## What this rule does
Prevents the use of HTML tags in Markdown - use Markdown syntax instead.
## Why this matters
- **Portability**: Pure Markdown works everywhere, HTML might be blocked or stripped
- **Security**: Many platforms sanitize HTML for security reasons
- **Simplicity**: Markdown syntax is cleaner and easier to read than HTML
- **Consistency**: Mixing HTML and Markdown creates inconsistent documents
## Examples
### ✅ Correct
```markdown
# Heading
This is a paragraph with **bold** and *italic* text.
> This is a quote
- List item 1
- List item 2
[Link text](https://example.com)

Contact us at
Visit
```
### ❌ Incorrect
```markdown
# Heading
This is a paragraph with bold and italic text.
This is a quote
Link text
```
### 🔧 Fixed
```markdown
# Heading
This is a paragraph with **bold** and *italic* text.
> This is a quote
- List item 1
- List item 2
[Link text](https://example.com)

```
## Configuration
```toml
[MD033]
allowed-elements = [] # List of allowed HTML tags (default: none)
allowed-inside = [] # Tags whose contents are allowed, whatever appears inside (default: none)
disallowed-elements = [] # List of disallowed HTML tags (enables disallowed-only mode)
fix = false # Enable auto-fix to convert simple HTML to Markdown (default: false)
fix-mode = "conservative" # conservative (default) or relaxed
drop-attributes = ["target", "rel", "width", "height", "align", "class", "id", "style"] # Used in relaxed mode
strip-wrapper-elements = ["p"] # Used in relaxed mode
br-style = "trailing-spaces" # Style for
conversion: "trailing-spaces" or "backslash"
# table-allowed-elements = ["br"] # Optional override for tags inside GFM table cells (see below)
```
Shorthand aliases are also supported:
```toml
[MD033]
allowed = [] # Alias for allowed-elements
disallowed = [] # Alias for disallowed-elements
```
### Example allowing specific tags
```toml
[MD033]
allowed-elements = ["br", "hr", "details", "summary"]
```
This would allow line breaks, horizontal rules, and collapsible sections while blocking other HTML.
### Allowing everything Markdown cannot express
Listing tags one by one means revisiting the config every time a document needs another
element. The special value `no-markdown-equivalent` in `allowed-elements` permits every
element that Markdown has no syntax of its own for, so only HTML a writer could have
written as Markdown is reported:
```toml
[MD033]
allowed-elements = ["no-markdown-equivalent"]
```
With that setting, ``, ``, ``, ``, ``, ``,
``, `` and the like are permitted, while ``, ``, ``, `
`,
`