---
title: "A grammar checker for Markdown on the Mac"
author: Pedro Thomaz
source: https://coffeetext.app/blog/grammar-checker-markdown-mac
---

# A grammar checker for Markdown on the Mac

> Checked November 2026 on macOS 26, against Harper's own site, linked below. Coffee isn't affiliated with Harper.

Markdown is good for writing and bad for most grammar checkers. Paste a note into a website and it trips over the hash signs and asterisks, or you clean them out first and then have to put them back. It's better to check where you write.

## The Mac's own checker

macOS has spelling and grammar checking built in, and apps that use the standard text system can turn it on. Look in the app's Edit menu, under Spelling and Grammar, for Check Grammar With Spelling. It underlines a suspect phrase, and a right-click offers fixes.

It's quiet and it's already there. It catches fewer mistakes than a dedicated checker, and it works only in apps that offer it.

In Coffee it's Check grammar, in Settings › Writing. It's off by default, like autocorrect beside it.

## Harper

[Harper](https://writewithharper.com/desktop) is a free grammar checker with a Mac app that works across other apps. It marks a mistake as you write, and a click puts the fix in. Its site has the details of what it checks and how it works.

To use it with Coffee:

1. Install Harper Desktop from its website and open it.
2. In Harper's settings, under Integrations, check that Coffee is in the list and switched on. If it isn't, choose Add application… and pick Coffee.
3. Write as usual. Harper's marks appear over the note.

In "We could of gone early", Harper marks "could of". Click it and choose "could have".

Harper draws its marks over the window, so nothing goes into your file but the fix you choose. A fix changes only those words, and ⌘Z in Coffee takes back just that fix.

## Style Check

Grammar is one thing and style is another. Coffee's View › Style Check marks filler words and repeated words as you write, and resting the pointer on a mark says why. It's a nudge, not a rule: change the words if you agree.

The marks never go into the file, and Style Check and Harper can be on together.

## What to watch for in Markdown

Whatever you use, check these after a fix:

- **Formatting around a change.** A fix inside `**bold words**` should leave the asterisks in place.
- **Code and links.** Grammar checkers don't know that `git restore` is a command or that a link's address isn't prose. Leave those marks alone.
- **Lists and headings.** Short list items often get flagged as fragments. That's fine in a list.

## Questions

### Is there a Grammarly alternative that works in Markdown?

Harper is a free grammar checker with a Mac app, and it works in Coffee's editor. The Mac's built-in grammar check is another option in apps that offer it.

### Do I have to paste my notes into a website?

No. The Mac's checker and Harper's Mac app both work where you write.

### Does a grammar checker change my Markdown?

It shouldn't change more than the words it fixes. In Coffee, a fix Harper puts in changes only those words, and the marks themselves never go into the file.

### Can I undo a grammar fix?

In Coffee, ⌘Z takes back the last fix, just those words, without touching the rest of the note.

---

Written by Pedro Thomaz, who makes Coffee, a Markdown editor for the Mac on macOS 15 or later, and for iPhone and iPad. It's free for 14 days with no card or account, then €3 a month, €29 a year, or €79 once with two years of updates. More at https://coffeetext.app/llms-full.txt
