CleanorTools
Markdown

Markdown Word Counter

Details

How to use Markdown Word Counter

What the tool does, how to run it, and what to expect from the result.

How to count Markdown words and structure

To count Markdown content, paste your source into the input box. The counter analyzes the text and reports words and characters alongside Markdown-specific counts, how many headings, links, and list items the document contains, so you get a fuller picture than a single word total.

Because the counter understands Markdown structure, it can separate the actual prose from formatting, giving more meaningful numbers when you are reviewing docs, README sections, or drafts. You can copy a clean summary of the counts for a review note or planning doc.

All counting happens locally in your browser. Your content is never uploaded to a server, so you can safely measure private drafts and internal documentation.

  • Paste your Markdown
  • Review words, characters, headings, links, and list items
  • Copy the summary

Why it beats a generic word counter

Markdown content usually needs more than one number. Headings, links, and list density often matter as much as total words when you are checking documentation, README sections, or content drafts for completeness and balance.

A plain text word counter would treat Markdown syntax as just more words and miss this structure entirely. This tool is Markdown-aware, so it reports the heading count, link count, and list-item count separately, which is far more useful for docs-oriented review.

That makes it a quick way to sanity-check a document before publishing, confirm a README has enough sections, or compare the structure of two drafts.

Tips

Getting a better result out of Markdown Word Counter

Specific settings and thresholds, not general advice.

  • Words and characters deliberately measure different things. Fenced code blocks and inline code are removed before words are counted, but the character count is the raw source length including every backtick, hash, and pipe. A code-heavy README will show a low word count and a high character count.
  • Link text counts as words; link URLs do not. [Read the docs](https://example.com/some/very/long/path) contributes three words, not the path, which is what you want when you are measuring how much a reader actually reads.
  • Headings are only counted when there is a space after the hashes. #Heading is not a heading here, and Setext headings underlined with === or --- are not counted at all, so a document that appears to have five headings may report three.
  • The link total counts every extracted match, and an inline http link also matches the bare-URL pattern, so a document with five inline links usually reports ten. Treat the link number as an upper bound rather than a count of distinct destinations.
  • List items require a space after the marker: -item is not counted, - item is. Both bullets (-, *, +) and ordered items (1.) count, which makes the list number a decent proxy for how scannable a page is.
Limits

What Markdown Word Counter does not do

The honest boundary, so you do not lose time finding it yourself.

  • One pasted block per run; there is no file upload or multi-document mode.
  • No reading-time estimate, readability score, or keyword density.
  • No per-heading or per-section breakdown.
  • The link count is a count of Markdown links, not a check that any of them resolve.
Reference

Terms used on this page

Short, plain-language definitions for the formats and settings above.

Files & formatsMarkdownMarkdown is a lightweight, plain-text formatting syntax that turns simple symbols into formatted text — `#` for headings, `*` for emphasis, and `-` for lists. It stays readable as raw text and converts cleanly to HTML.General
At a glance

Who Markdown Word Counter is for

A quick way to understand who this helps, what it solves, and where it connects next.

Best fit

Docs writers, SEO teams, content reviewers, and founders checking Markdown length and structure before publishing.

Ideal for

Quick Markdown audits where word count alone is not enough and headings, links, or list density also matter.

FAQ

Common questions

Short answers for the questions people usually have before trying a utility like this.

Is the Markdown Word Counter free?

Yes. This tool is completely free to use, with no sign-up required.

Does it upload my content anywhere?

No. All counting happens locally in your browser, so your content stays on your device.

Does it count links and list items too?

Yes. The output includes words, characters, headings, links, and list items.

Is this just a plain text word counter?

No. It is aware of Markdown structure, which makes it more useful for docs and README review than a generic word counter.

Does it work on mobile?

Yes. The counter runs in any modern browser, including mobile, since all processing happens on your device.

Why is my word count lower than my editor's?

Code is excluded. Fenced blocks and inline code are stripped before words are counted, along with image alt text and autolink URLs, and the remaining Markdown punctuation is treated as whitespace. A general-purpose editor counts all of that as words, which is why a technical document shows a large gap between the two numbers.

Why is the link count higher than the number of links I can see?

The extractor matches five patterns and they overlap. An inline link with an http target also matches the bare-URL pattern, and an image with alt text also matches the inline pattern, so each of those links is counted more than once. Use the number as an upper bound, or use the Markdown Link Extractor and de-duplicate by URL.

Does the character count include the Markdown syntax?

Yes. Characters is the raw length of what you pasted, hashes, backticks, brackets and all. That is the number to use when you are checking against a hard field limit, since the field will store the source. Use the word count when you are judging how much a reader will read.

Why is one of my headings not counted?

Almost certainly a missing space after the hashes. The heading pattern requires at least one space, so #Overview is not counted while # Overview is. That is also how the renderer sees it, so an uncounted heading is usually a heading that is not rendering as one either.

Is my content uploaded to be counted?

No. The counting runs in the browser and the summary and JSON downloads are produced locally, so drafts and internal documents stay in the tab.

Is there a reading-time estimate?

No. Reading time is a word count divided by an assumed words-per-minute figure, and that figure varies enormously for technical content with code blocks in it. The word count is given straight, and you can divide it by whatever rate your team uses.

Recommendations

You Might Also Like

Nearby tools from the catalog that fit the same job or workflow.

WORD
UtilityCount

Word Counter

Count words and characters

Count words, characters, sentences, paragraphs, and lines in your text as you type. Free, in your browser, no upload.

README
UtilityMarkdown

README Builder

Assemble a practical README

Assemble a practical README from common project sections and export one clean README.md locally.

CHAR
UtilityCount

Character Counter

Count characters

Count characters with and without spaces, plus words and lines, as you type. Free, in your browser, no upload.

H2MD
UtilityMarkdown

HTML to Markdown

Convert HTML to Markdown

Convert practical HTML snippets into Markdown locally and preview the result.

TASK
UtilityMarkdown

Markdown Checklist Generator

Generate task lists

Turn plain lines into a Markdown task list with checked or unchecked defaults.

CLEAN
UtilityMarkdown

Markdown Cleaner

Clean Markdown spacing

Clean Markdown spacing, heading gaps, list spacing, fence spacing, and trailing whitespace locally.

Cleanor app

Do it all on your device

Cleanor puts these tools in one app: compress and convert images, video, and audio, work with PDFs, and scan text right on your device. Plus free up storage and clear inbox clutter with Email Cleaner. Start with a free trial.

  • iPhone
  • Android
  • Macsoon
  • Windowssoon
Get it on the App StoreGet it on Google PlayAll platforms & pricing