# 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) ![Image description](image.png) Contact us at Visit ``` ### ❌ Incorrect ```markdown # Heading This is a paragraph with bold and italic text.
This is a quote
Link text Image description ``` ### 🔧 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) ![Image description](image.png) ``` ## 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 ``, ``, ``, ``, `