Dashes  |  Google developer documentation style guide  |  Google for Developers (2024)

Em dashes

To indicate a break in the flow of a sentence—or an interruption—use an emdash, 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 onyour flavor of Linux—for examples, see Linux Keyboard Shortcuts ForText Symbols). After the Compose key is enabled, you can create an em dashby 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 ofan em dash is gradually becoming more common, but it's still not very widespreadin the US in professional publishing; so far (as of early 2016), it's mostlyused 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:

• Ranges of numbers with units
• Range of numbers

Colons instead of dashes in description lists

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

 <dl> <dt>Example</dt> <dd>This is an example.</dd> <dt>Another example</dt> <dd>This is another example.</dd> </dl>