Markdown Cleaner
Clean and normalize Markdown directly in your browser. Fix inconsistent whitespace, line endings, headings, bullets, and more while preserving important structures such as code, tables, and front matter.
Your Markdown is cleaned locally in your browser and is never uploaded for processing.
Release to load file
Accepted uploads: .md, .markdown, or .txt, up to 5 MB. Drag a file onto the editor, or use Upload File.
Formatting Issues Found
No obvious formatting issues detected.
Editing happens in Original Markdown. Change your source or settings, then click Clean Markdown again — this panel is read-only.
Changes Made
Lines changed: 0
Characters: 0 → 0
Issues fixed: 0
No changes yet — click Clean Markdown to see a summary here.
Change Breakdown
Safe Cleanup uses conservative rules intended to avoid changing rendered Markdown meaning. Consistent Markdown and AI-Ready Cleanup add optional formatting normalization — AI-Ready Cleanup also removes non-rendered HTML comments and invisible formatting artifacts.
Safe / Conservative Cleanup
Normalize Line Endings
Converts CRLF and lone CR line endings to LF everywhere, including inside code blocks. Nothing else about the line is changed.
Remove Leading Blank Lines
Removes empty or whitespace-only lines before the first meaningful content. Never removes YAML front matter.
Safe Trailing Whitespace Cleanup
Removes a single accidental trailing space, but keeps exactly two trailing spaces where they exist — Markdown's hard-line-break convention. Whitespace-only blank lines become truly empty. Code blocks are never touched.
Collapse Excessive Blank Lines
Limits consecutive blank lines outside code blocks and front matter to the maximum below.
Ensure Final Newline
Ensures the output ends with exactly one newline, without adding multiple blank lines at the end of the file.
Optional Formatting Normalization
Standardize Bullet Markers
Normalizes recognized unordered list markers (*, +) to -. Never touches horizontal rules, code, or unrelated text.
Normalize Heading Spacing
Normalizes spacing between a heading marker and its text, only on lines already recognized as valid ATX headings.
Normalize Blockquote Spacing
Normalizes spacing after recognized blockquote markers while preserving nesting depth.
Normalize Task Checkbox Case
Normalizes completed task markers [X] to [x]. Unchecked [ ] items are left unchanged.
Aggressive Cleanup
Remove HTML Comments
Removes <!-- comments --> outside code blocks. This rule changes document content, not just formatting.
Remove Zero-Width Artifacts
Removes stray zero-width spaces (U+200B) and byte-order marks (U+FEFF). Never removes U+200C or U+200D, which can carry legitimate linguistic or emoji meaning.
Cleaning…
How to Clean Markdown
- Paste Markdown into the editor, or use Upload File (or drag and drop) to load a .md, .markdown, or .txt file.
- Choose a cleanup preset — Safe Cleanup, Consistent Markdown, AI-Ready Cleanup, or Custom — or adjust individual rule toggles.
- Click Clean Markdown to run the selected rules.
- Review the diagnostics and the cleaned output alongside your original source.
- Copy the result or download it as a Markdown file.
What Is Markdown Cleaning?
Markdown cleaning means correcting unnecessary or inconsistent text formatting — extra blank lines, stray trailing whitespace, mismatched line endings — while preserving the meaningful structure of your document. MarkForge's Markdown cleaner runs entirely in your browser, operating directly on your original source text rather than regenerating Markdown from a parsed representation, so syntax you didn't ask it to touch stays exactly as you wrote it.
Not every Markdown file needs cleaning, and MarkForge is conservative around protected structures such as code, tables, and front matter — see Protected Markdown Structures below for details.
What MarkForge Can Clean
Depending on the settings you enable, MarkForge can address:
- excessive blank lines between blocks
- accidental trailing whitespace
- mixed CRLF/CR/LF line endings
- inconsistent unordered-list bullet styles
- inconsistent heading spacing
- inconsistent blockquote spacing
- inconsistent task-checkbox capitalization
- HTML comments
- invisible zero-width character artifacts
Exactly which of these are changed depends entirely on the cleanup preset and individual rule toggles you select — nothing is cleaned automatically beyond what's enabled.
Clean and Format Markdown Consistently
MarkForge can clean and normalize common Markdown formatting inconsistencies — including inconsistent bullet markers, heading spacing, and blockquote spacing — which overlaps with some of what people look for in a Markdown formatter online.
Unlike a fully opinionated formatter that rewrites an entire document to one canonical style, MarkForge intentionally preserves protected structures such as code, tables, and front matter, and only applies the specific rules you've enabled. The result is Markdown that's more consistent, not a document rebuilt from scratch.
Choose a Markdown Cleanup Preset
Safe Cleanup is the default preset. It uses conservative rules — line-ending normalization, leading blank-line removal, safe trailing-whitespace cleanup, blank-line collapsing, and a final newline — intended to avoid changing how your Markdown renders.
Consistent Markdown and AI-Ready Cleanup layer on optional formatting normalization, such as standardizing bullet markers and heading spacing. AI-Ready Cleanup goes further still, removing non-rendered HTML comments and invisible zero-width characters. These are content-level changes, not purely cosmetic ones, so they stay off by default.
Custom lets you enable or disable each rule individually instead of using a preset — useful if you want, for example, heading-spacing normalization without HTML-comment removal. Toggling any individual rule automatically switches the preset selector to Custom.
Why Clean Markdown?
Messy Markdown formatting shows up often in documentation, README files, notes, and content pulled from Git repositories or static-site generators — and increasingly in Markdown generated by AI tools, which can leave behind inconsistent spacing, stray HTML comments, or invisible characters. Cleaning up these artifacts makes source files easier to review, diff, and maintain, and gives knowledge bases and AI/RAG preprocessing pipelines a more consistent starting point.
Markdown Whitespace and Line Breaks
In standard Markdown, two or more trailing spaces at the end of a line create a hard line break — a deliberate line ending within the same paragraph, without starting a new one. Because that whitespace is meaningful, a cleaner that blindly strips every trailing space would silently break that formatting. (Not every Markdown renderer treats trailing-space line breaks identically, so always check your target renderer if this matters for your document.) See Markdown line breaks for a fuller explanation of ordinary newlines, hard breaks, and paragraphs.
MarkForge's Safe Trailing Whitespace Cleanup rule preserves this behavior: a single accidental trailing space is removed, but two or more trailing spaces are normalized to exactly two, keeping the hard break intact instead of deleting it. Separately, excessive blank lines between blocks are reduced according to the Collapse Excessive Blank Lines setting and its maximum-blank-lines limit, whichever preset you're using.
Protected Markdown Structures
MarkForge avoids applying formatting-normalization and whitespace rules inside content it recognizes as structural: fenced code blocks, indented code blocks, Markdown tables, and YAML front matter at the top of a document. These ranges are detected before any rule runs, so the bullet, heading, blockquote, task-checkbox, and trailing-whitespace rules never touch them.
Optional line-ending normalization is the one exception — because it only changes the CRLF/CR/LF terminator bytes at the end of a line, not the content itself, it applies everywhere, including inside code blocks. Inline code spans on the same line are also specifically protected from HTML-comment and zero-width-character removal.
Remove Hidden Markdown Clutter
When enabled, MarkForge can remove HTML comments and stray zero-width characters — zero-width spaces and byte-order marks — that are easy to miss but can clutter a document or confuse downstream tooling. Zero-width non-joiners and joiners, which can carry legitimate linguistic or emoji meaning, are never removed.
Both rules skip protected structures and same-line inline code spans, and only remove clutter — they never rewrite or reword the surrounding visible text.
Clean Markdown for AI Workflows
Markdown used in AI and LLM workflows can pick up inconsistent spacing, repeated formatting artifacts, stray HTML comments, or invisible characters after conversion or editing. MarkForge's AI-Ready Cleanup preset can normalize supported formatting and remove that kind of clutter — it does not summarize, rewrite, or otherwise change the wording of your content, and nothing is sent to an AI model or provider.
Once your Markdown is cleaned, a natural next step is to preview it to confirm it renders as expected, split longer documents into chunks for RAG and knowledge-base pipelines, and check the token count before sending it to a model.
Private by Design
Markdown cleanup happens entirely locally in your browser. Uploaded files, pasted Markdown, cleaned output, and diagnostics are never uploaded to a MarkForge cleaning server, and downloads are generated locally rather than on a server.
For additional details, see the MarkForge Privacy Policy.
Related Tools
PDF to Markdown Converter →
Convert PDF files into clean, structured Markdown directly in your browser.
DOCX to Markdown Converter →
Convert Microsoft Word DOCX files into clean Markdown directly in your browser.
HTML to Markdown Converter →
Convert HTML source or HTML files into clean Markdown directly in your browser.
AI Token Counter →
Count tokens, words, and characters and compare text against an AI context window.
Markdown Previewer →
Write or paste Markdown and see a live formatted preview in your browser.
Markdown Chunker →
Split large Markdown documents into structured chunks for AI, RAG, and knowledge-base workflows.
Frequently Asked Questions
What is a Markdown cleaner?
A Markdown cleaner removes unnecessary formatting artifacts — such as excess blank lines, trailing whitespace, and mixed line endings — and standardizes Markdown style, while trying to preserve the document's content and structure.
How do I clean Markdown?
Paste or upload Markdown, choose Safe Cleanup, Consistent Markdown, AI-Ready Cleanup, or Custom, click Clean Markdown, then review the diagnostics and cleaned output before copying or downloading the result.
What does MarkForge remove from Markdown?
Depending on the rules you enable, MarkForge can normalize line endings, remove leading blank lines, trim accidental trailing whitespace, collapse excessive blank lines, ensure a final newline, standardize bullet markers, normalize heading and blockquote spacing, normalize task-checkbox case, remove HTML comments, and remove stray zero-width characters.
Will MarkForge rewrite my text?
No. MarkForge is a formatter and cleaner, not a rewriting engine. It never summarizes, rewrites, or translates prose, changes wording, renumbers ordered lists, removes links or emphasis, or changes heading levels.
Is MarkForge a Markdown formatter?
MarkForge can clean and normalize common Markdown formatting inconsistencies, but it's designed as a conservative cleaner rather than a complete, opinionated formatter that rewrites every part of a document.
Does Markdown whitespace matter?
Sometimes. Most trailing whitespace is accidental and safe to remove, but two or more trailing spaces at the end of a line create an intentional Markdown hard line break. See Markdown Whitespace and Line Breaks above for details.
Does MarkForge preserve Markdown hard line breaks?
Yes. Safe Trailing Whitespace Cleanup normalizes three or more trailing spaces down to exactly two — preserving the hard break — while removing a single accidental trailing space entirely.
Does MarkForge change code blocks?
No. Fenced and indented code block contents are left untouched by every rule except optional line-ending normalization, which only changes the terminator bytes, not the code itself.
Does MarkForge change Markdown tables?
No. MarkForge does not reformat table cells, change alignment markers, or collapse spacing inside a Markdown table in this version.
What is Safe Cleanup?
Safe Cleanup is the default, conservative preset: line-ending normalization, leading blank-line removal, safe trailing-whitespace cleanup, blank-line collapsing, and a final newline. It's intended to avoid changing how your Markdown renders.
What is Consistent Markdown?
Consistent Markdown includes everything in Safe Cleanup plus optional formatting normalization: standardized bullet markers, heading spacing, blockquote spacing, and task-checkbox case.
What is AI-Ready Cleanup?
AI-Ready Cleanup includes everything in Consistent Markdown plus removal of HTML comments and stray zero-width character artifacts. It performs more normalization than Safe Cleanup and can remove non-rendered content, so review the result before relying on it.
Can MarkForge remove HTML comments?
Yes, when the Remove HTML Comments rule is enabled. It removes <!-- comments --> outside code blocks only — it does not strip other HTML, and comments shown inside a code block are left alone.
What are zero-width characters?
Zero-width characters are invisible Unicode characters sometimes left behind by copy-paste or AI-generated text. MarkForge's Remove Zero-Width Artifacts rule conservatively removes stray zero-width spaces (U+200B) and byte-order marks (U+FEFF), but never removes zero-width non-joiners (U+200C) or zero-width joiners (U+200D), which can carry legitimate linguistic or emoji meaning.
Can I upload a .md file?
Yes. MarkForge accepts .md, .markdown, and .txt files up to 5 MB, read entirely in your browser. You can also drag and drop a file onto the editor.
Can I download the cleaned Markdown?
Yes. Download .md saves the cleaned output as a UTF-8 Markdown file generated locally in your browser. You can also use Copy Cleaned Markdown to copy it directly.
Does MarkForge upload my Markdown?
No. Pasted Markdown, uploaded files, and cleaned output are processed locally in your browser and are never sent to a MarkForge server or any third-party API.
Is Markdown Cleaner free?
Yes. The Markdown Cleaner is free to use and does not require an account.