In an English sentence, “June report” looks tidy. In a command example, those characters can behave differently from "June report". Two hyphens in an option such as --label can also turn into a single long dash. A snippet that looks fine in a blog can fail when a reader pastes it.

Try the exact characters in the app you write in

Open a scratch file in the Mac app that will hold the snippet. In apps that offer Apple’s substitutions controls, open Edit → Substitutions and review Smart Quotes and Smart Dashes. Turn those off when entering literal command text. If the app uses its own formatting controls, use its plain-text or code entry mode and run the same check there.

A character comparison showing ASCII quotation mark U+0022 and hyphen-minus U+002D alongside typographic substitutes.

Character comparison. A curly quote or an en dash may look close while encoding a different character.

demo --label "June report"

The line is a sample for inspection. Type it in the editor, copy it from the finished document or preview, then paste into a plain-text scratch file. Look at each quote and count the two hyphens immediately before label. Checking the published or exported text catches transformations that happen after you finish editing.

A plain-text test card with the sample command demo --label "June report" and a note to inspect it without running it.

Scratch example. Check the pasted text without executing the command.

If a snippet has already been changed, replace the punctuation inside that snippet and copy it again for another check. In a document with prose and commands, preserve the intended punctuation in each context.

Reference Apple’s guide to text and punctuation substitutions.