Tool

Technical Writing Linter

Paste a technical article or tutorial to check it against 16 writing rules. Each finding names the rule it broke and quotes the text that triggered it, and nothing you paste leaves your browser.

article.txt
⌘↩ to run
0 words
results.log
{ }

Findings appear here after you run the linter.

Rules

What gets flagged

error
  • Paragraph length. Flags a prose paragraph with more than two sentences.
  • Em dashes. Replace each em dash (—) with a comma, a period, or parentheses.
  • Contrastive parallelism. Flags "unlike X, Y…", "whereas", and "on the other hand". State the evidence instead of the contrast.
  • Horizontal lines. Replace a --- section divider with a heading or white space.
  • Banned jargon. Flags "leverage", "synergy", and "unlock". Name the action the word stands in for.
  • Banned sentence openers. Flags sentences that start with "In", "This", "By", "Finally", "Most", or "Ever".
  • Condescension words. Flags "simply", "just", "easy", "obviously", and "of course". Each one tells a stuck reader the step should not have stopped them.
  • AI writing signals. Flags "delve", "in conclusion", "it's worth noting", "rapidly evolving", and "harness the power". Readers take these phrases as a sign that a model wrote the page.
  • Filler openers. Flags phrases such as "In this article…" and "Today we will learn…", which announce the article instead of starting it.
warning
  • Hedge words. Flags "very", "really", "quite", and "basically". Each one weakens the claim it modifies.
  • Buzzwords. Flags "seamless", "robust", "cutting-edge", and "utilize". Replace each with the property you can show.
  • Filler phrases. Flags "in order to", "note that", "please note", and "as you can see". Delete them and the sentence loses nothing.
  • Tutorial "we". Flags "we will" and "let's". Address the reader as "you".
info
  • Personal voice. Flags an article of 100 words or more with no first-person reference. Add one only where a real decision or experience makes the article more useful.
  • Passive voice. Found by pattern and marked for review, because some passive sentences are the right choice.
  • Long sentences. Flags sentences over 35 words. Split them so a reader scanning the page gets one claim at a time.
  • Reading ease. The stats line shows a Flesch reading ease score from 0 to 100 for text of 20 words or more. The score is shown for reference and does not change the grade.

Need writing that passes its own linter?

I write technical articles and docs for developer-tool and B2B SaaS teams, and I test each claim against the product.

Book a Call → Read the Writing