To indicate a break in the flow of a sentence—or an interruption—use an em
dash, also known as a long dash. Don't put a space before or after it.
You can type the em dash character in various ways:
HTML
—
macOS
Press Option+Shift+hyphen.
Linux desktop environment
Enable the Compose key (instructions for doing that vary depending on
your flavor of Linux—for examples, see Linux Keyboard Shortcuts For
Text Symbols). After the Compose key is enabled, you can create an em dash
by typing the Compose key followed by three hyphens.
Alternatively, press Control+Shift+U. Let go of those keys, and then type
2014. Then press Return.
Windows
Turn num lock on, and then hold down the left Alt key and type 0151
on the numeric keypad.
Don't use an en dash (the shorter dash) or a hyphen in place of an em dash.
The use of an en dash with spaces around it in place of
an em dash is gradually becoming more common, but it's still not very widespread
in the US in professional publishing; so far (as of early 2016), it's mostly
used in Canada and a few other places. For now, only use the em dash.
En dashes
Don't use. Instead, use a hyphen or the word to. For more information, see
the following:
Another common but nonstandard construction is to use an em dash, an en dash, or a hyphen
surrounded by spaces to separate an item and its description. Instead, use
a colon or a period.
For a series of items, use
an HTML description list (<dl>).
Recommended: Example: This is an
example.
Not recommended: Example - This is
an example.
Recommended: Appendix A: My first
appendix
Not recommended: Appendix A—My first
appendix
Recommended:
<dl>
<dt>Example</dt>
<dd>This is an example.</dd>
<dt>Another example</dt>
<dd>This is another example.</dd>
</dl>
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-15 UTC."],[[["Em dashes indicate a break or interruption in a sentence and should not have spaces before or after."],["To create an em dash, use the HTML entity `—` or platform-specific keyboard shortcuts (provided in the content)."],["Avoid using en dashes or hyphens in place of em dashes; instead, use hyphens or the word \"to\" where appropriate."],["Use colons or periods (or HTML description lists for multiple items) to separate items and their descriptions instead of dashes."]]],["Em dashes, used for breaks or interruptions in sentences, should not have spaces before or after. They can be entered using HTML code `—` or specific key combinations on macOS, Linux, and Windows. Do not substitute en dashes or hyphens for em dashes. Colons or periods, not dashes, should separate items and their descriptions. For item series, use HTML description lists.\n"]]