63

Different people use different terminology and symbols for Mac keys/commands. I figured we should have one standardized list that can be a point of reference for editing guidelines.

In general, the site should follow Apple’s Style Guide and the macOS Human Interface Guidelines to avoid confusion:

Usage:

  • Names go from most to least common, so use the first in the list whenever possible.

  • Terms in italics are obsolete, slang, and/or terms used on other platforms; these should only be used when it's unavoidable.

  • No images were used here so that the symbols can be copied/pasted into questions and answers (and please do!).

  • When typing shortcuts, don't include characters that aren't pressed. In Safari, for instance, ⌘+ zooms in while ⌘- zooms out. Using ⌘++ or ⌘-+ would just be confusing.

  • The <kbd> tag is problematic: for instance, ⌘+ is readable, but ⌘⇥ is not.

  • Bolding shortcuts helps readability, but not inside <kbd> tags.
    • **⌘+** becomes ⌘+
    • **⌘⇥** becomes ⌘⇥
    • <kbd>**⌘+**</kbd> becomes ⌘+
    • <kbd>**⌘⇥**</kbd> becomes ⌘⇥

  • When typing shortcuts, don't separate keystrokes that must be made together. For instance, typing in N N or N N produce different results—and the latter makes it clear which two need to be pressed simultaneously.
    • If you're using the <kbd> tag, that means use N N, not N N.

Icon
                Name(s) and alternate symbols

                Command, Cmd, Cmnd, Clover, Apple

                Control, Ctl, Ctrl

                Option, Opt, Alt

                Shift

                Caps lock

                Eject

                Return, Carriage return, ,

                Enter, ,

                Delete, Backspace,

                Forward delete, Fwd delete, Delete,

                Escape, Esc,

                Right arrow

                Left arrow

                Up arrow

                Down arrow

                Page up, PgUp

                Page down, PgDn

                Home

                End

                Tab, Tab right, Horizontal tab,

                Shift tab, Tab left

                Space, Blank,

Notes:

  • I'm not crazy about the way this looks either, but there's a limit to what I can do without tables and formatting. If you can improve it, please do!
  • This is currently solely based on the American English keyboard, so it could really use some internationalization help.
  • These didn't come down from on high; it's a work in progress based on community consensus. If you have suggestions for changes or ideas for additions, add them below for discussion.

Edited to add:

For those who can't see the table above, or who want to know what to type in rather than copy paste, this might help:

alt text

21
  • 4
    looks great, thanks for making this
    – Kyle Cronin Mod
    Commented Dec 11, 2010 at 18:47
  • 6
    this post is love in a bottle +1 Commented Dec 11, 2010 at 20:06
  • 1
    nice job Dori, I like it Commented Dec 11, 2010 at 20:09
  • 1
    Is there an easy way to enter those characters on a keyboard in OSX? Shy of hunting them down in the Character Viewer? Commented Dec 13, 2010 at 2:35
  • What a shame. If you ever learn another easy method, post it here, will 'ya? :) Commented Dec 13, 2010 at 4:26
  • 1
    This totally doesn't work on Win+IE. All I see is bullets and squares. Commented Dec 13, 2010 at 7:12
  • If I could re-upvote you I would. You missed a linebreak between the second and third 'return' icons, however. edit I can re-upvote you, that comment! Duh. Commented Dec 13, 2010 at 10:34
  • 4
    @Dori why is "alt" obsolote, when it is written on the keyboard?
    – Tyilo
    Commented Aug 8, 2011 at 9:27
  • @Dori It certainly isn't slang, and it's written on both my mac keyboards, so I can't see that it's only used on other platforms.
    – Tyilo
    Commented Aug 10, 2011 at 11:48
  • Thank you very much for compiling this list. I've needed something like this many times. Except I didn't know about it...
    – daviesgeek
    Commented Sep 7, 2011 at 16:07
  • Adding Arial Unicode MS to the list of fonts inide <kbd> might help for IE users.
    – kinokijuf
    Commented Jan 13, 2012 at 21:24
  • 1
    Also, why isn’t Control a simple ^ (caret)?
    – kinokijuf
    Commented Jan 13, 2012 at 21:32
  • 1
    The list is missing ⌧ (clear). ␣ is also more common than ␢.
    – Lri
    Commented Jul 10, 2012 at 16:51
  • 1
    Casting my vote for ⎵ over ␢. ⎵ is much more common; ␢ is quite rare. It's worth noting, though, that in menus, Apple just writes "Space".
    – Zenexer
    Commented Aug 27, 2015 at 16:39
  • 1
    Control isn't a simple ^ (caret) because the caret is too narrow. See? ^⌃
    – SilverWolf
    Commented Nov 13, 2017 at 15:16

6 Answers 6

35

I disagree about combining control modifiers into the same kbd tags. For example, rather than

To quit, type: ⌘Q

I think that the following makes much more sense:

To quit, type: +Q

For a few reasons:

  1. There is no ⌘Q key. using a <kbd> tag makes the item appear like a key on the keyboard, and placing ⌘Q together inside the <kbd> tag gives the appearance that there is a single key ⌘Q, when in fact there are two seperate keys
  2. Despite my personal dislike of the "+" sign in the above notation, it is the most common way of indicating that two keys should be pressed in conjunction.
4
  • 8
    I also feel strongly that it's confusing to have the tag make up a key that doesn't exist. The tag denotes a physical key - not that two keys should be pressed in sequence or synchronically. I think it's good to debate whether _ or + or , or - or nothing to separate them, but inventing an imaginary combination key is what having two characters inside the same <kbd> tag implies to me.
    – bmike Mod
    Commented Aug 12, 2011 at 18:59
  • I would also like to add that we should maybe follow what Apple actually puts on their recent keyboards: i.e. write <kbd>shift</kbd> not <kbd>&#8679;</kbd> and <kbd>option</kbd> not <kbd>&#8997;</kbd>
    – Asmus
    Commented Dec 23, 2011 at 13:08
  • I agree about combining the modifiers
    – daviesgeek
    Commented Jan 27, 2012 at 17:01
  • Also, for Mac modifiers, you shouldn't use &lt;kbd&gt; tags at all, the system displays them bare in menus. (:
    – SilverWolf
    Commented Nov 13, 2017 at 15:18
9

Let's take a look at all the different options here:

  1. To take a screenshot of the entire window press 4, select the file on your desktop and copy it with C

  2. To take a screenshot of the entire window press ⌘ Command ⇧ Shift 4, select the file on your desktop and copy it with ⌘ Cmd C

  3. To take a screenshot of the entire window press Command Shift 4, select the file on your desktop and copy it with Command C

  4. To take a screenshot of the entire window press ⌘ Command + ⇧ Shift + 4, select the file on your desktop and copy it with ⌘ Cmd + C

Number 2 seems like the best option; It uses the proper notation used throughout Mac, and also uses the name as it appears on the keyboard (so it's much easier for novices to know what they're actually supposed to do.

I don't understand the need to separate each key with the + symbol. It makes sense when you're writing keyboard shortcuts in plain text where you have no way to visually distinguish between different keys, but condsidering we have <kbd> I just don't see a need for it.

Also, AskDifferent is supposed to be a site for learning, right? Using ⌥ Option people would finally be able to figure out what that crazy symbol is!

6

Is there something StackExchange can develop to make this easier? Some tag/macro they can develop in order to sanely enter these characters? I like having a source, which this post is perfect for, but I like something more that doesn't unfocus me from the question/answer at hand.

2
4

Oh yes this is readable - NOT!

mumbo jumbo

4
  • 3
    It's supposed to look like this. It's OK on Macs and iOS devices because they have fonts that can display the characters built in, but unfortunately it'll look broken on Windows. Not an ideal situation, but since the keyboard shortcuts are only useful to those that have Macs, it might be acceptable.
    – Kyle Cronin Mod
    Commented Dec 13, 2010 at 7:44
  • 2
    @Dori It supports Unicode, it just doesn't have any fonts that have the required characters. I think most of the symbols are custom-made by Apple and wouldn't be expected to be supported on other platforms.
    – Kyle Cronin Mod
    Commented Dec 13, 2010 at 9:50
  • 2
    @dori: it's really incomprehensible... i've had a little unknown character symbol next to the name of every person in my contact list who sends me an email in gmail since windows xp. It's a standard unicode character that looks like a telephone icon. The first time i get on a macbook, lo and behold, the character shows up just fine! I'm not sure how unicode support is still a problem in Windows after all these years. Not sure, but I think it's more a problem with the default fonts used by browsers in windows rather than lack of unicode compatible fonts. Commented Dec 13, 2010 at 15:48
  • @KyleCronin All characters currently listed in the question are standard Unicode characters. (Not private use area characters with a special meaning in some fonts like the Apple logo character.)
    – Lri
    Commented Jul 11, 2012 at 7:07
2

Should the arrows actually be arrows-with-tails as currently listed, or should they be replaced with ▲ ◀ ▼ and ▶ which are used on the arrow keys currently?

(http://www.visibone.com/htmlref/char/cer09600.htm for ease of HTML entity reference.)

3
  • Also, the sheer number of size-difference only characters of those symbols is so freaking annoying. Commented Dec 29, 2010 at 20:20
  • Fair enough, makes sense. Commented Dec 29, 2010 at 21:57
  • 4
    I wish the keyboard would be printed with the same characters as are drawn in the menu bar. Can we all file a bug report with apple now to riot for some consistency?
    – bmike Mod
    Commented Aug 12, 2011 at 19:01
-10

This seems like a lot of extra hassle for essentially no tangible gain. Unlike, say, Math Overflow, math.SE, or LaTeX.SE, symbolic notation here is simply beyond unnecessary (I refuse to say something so trite as "in my opinion", but given the recent allegations that I use "weasel words", this is a reverse disclaimer, in that these views are my own and not the views of "people in general", as it were.). This is a Q&A site for enthusiasts/power users of a certain brand of electronic device. In fact, this kind of thing gives one (by which I mean your humble servant) the impression of "trying too hard", as it were.

Further, albeit less related to the original post, it seems clear to me, at least, that this site would do well to drop the overwhelming aura of seriousness. Being an Apple fan, power user (alas, gone are the days when the users of the powermac/book quite literally "power users"), simply does not require that we speak and act with such gravity (as opposed to levity!). This is a Q&A site about the products of Apple Computer for experienced users. Lobotomizing away the personality and panache from people's posts (alliteration not intended) does not make the subject matter any more substantial or important.

Thank you for your time.

Cordially yours,

Harry

5
  • 8
    The symbolic notation for keyboard shortcuts is widely used in Mac OS X - just open up the menu in any program - so it makes perfect sense to use it here as well. As far as "lobotomizing" the "personality" and "panache" from your posts, it's standard practice on the Stack Exchange network to remove unnecessary editorialization from anyone's posts.
    – Kyle Cronin Mod
    Commented Dec 13, 2010 at 7:53
  • Dear @Kyle, are you trying to run a Q&A site or compile an encyclopedia? I understand things like "remove unnecessary swearing", but editorializing includes the following example: (I'll do it in programming-speak for your entertainment, so you can chuckle at how little I know about programming): Suppose someone asks a specific question, like, "Hey, store ints as floats?" Then the answer would be something like "yes, here's how you do it". And editorializing would be, "and here's why you shouldn't". Further, when I write, I write as "I, the author". It's rather clear when you look at my Commented Dec 13, 2010 at 8:20
  • posts what is my opinion and what is general opinion. There is a general way of writing mathematics (I think that it comes from the French), where one uses "we", as in, I the writer, and you the reader. Is this the "editorializing that you're so against? Commented Dec 13, 2010 at 8:25
  • 8
    It's more phrases like "Every self-respecting Macintosh user knows that in terms of usability, the dock, while pretty, is even worse than the Micro$oft Windblows taskbar." and "Because I'm such a nice guy, I'm not going to rag on the OS X developers for the following completely inane design decision" that are unnecessary. And yes, one of the goals behind Stack Exchange is a bit encyclopedic in that the questions and answers are intended to be useful both to the original asker and additionally to people coming in off Google with the same question.
    – Kyle Cronin Mod
    Commented Dec 13, 2010 at 8:49
  • @Kyle: The second one doesn't even resemble editorializing at least for the definitions of editorializing I've found. It does not assert that the opinions are held by anyone other than myself. Further, it's clearly a joke since it very blatantly contradicts itself. It's like saying, "I'm not trying to be mean or anything, I just want to see you shed one tear." or "I'd never hit a woman, but just last week, my wife started nagging me while I was watching the game, so I punched her in the uterus to shut her up". Commented Dec 13, 2010 at 9:19

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .