New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Mac Command key #428

rgaiacs opened this Issue Sep 9, 2018 · 2 comments


None yet
3 participants

rgaiacs commented Sep 9, 2018 says

hit <kbd>Ctrl</kbd>+<kbd>Return</kbd> in Windows or Linux or <kbd>⌘</kbd>+<kbd>Return</kbd> on OS X.

but recommends to say

hit <kbd>Ctrl</kbd>+<kbd>Return</kbd> in Windows or Linux or <kbd>Command</kbd>+<kbd>Return</kbd> on OS X.

The reasons why I decided to use <kbd>Command</kbd> instead of <kbd>⌘</kbd> are (1) text to speak might better read the word instead of the symbol and (2) type the word doesn't require knowledge of how to insert special characters.


This comment has been minimized.


jcoliver commented Sep 12, 2018

Good idea. Is there potential for confusion/conflict with non-English keyboards, though? Is there a way to keep the key name and the symbol?


This comment has been minimized.


lucymchang commented Nov 16, 2018

It seems like it's rare to find a physical Apple keyboard that does not have the word "command" or "cmd" associated with the symbol, even on international keyboards. I think both points @rgaiacs brought up are good ones. That being said, it would be quite useful to include both the symbol and key name. has been formatted this way and appears quite clear, though this would require a change to the style guide.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment