This page is In Progress

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

kbd

Summary

The 'kbd element denotes user input. Typically this is keyboard input (hence “kbd”), but it may also be used to represent other user input, e.g. voice commands or gestures.

Overview Table

DOM Interface
HTMLElement

Examples

This example uses the kbd element to convey a command line command to the user.

<p>Type the command <kbd>git status</kbd>
to see the working tree status.</p>

This example illustrates using kbd to indicate keystrokes.

<p>Press <kbd><kbd>Ctrl</kbd>+<kbd>s</kbd></kbd>
to save your document.</p>

Usage

 The kbd element is a phrasing-level element. It must not contain block-level elements, but it can contain other phrasing-level elements.

Notes

When the kbd element is nested inside a samp element, it represents the input as it was echoed by the system.

When the kbd element contains a samp element, it represents input based on system output, for example invoking a menu item.

When the kbd element is nested inside another kbd element, it represents an actual key or other single unit of input as appropriate for the input mechanism (see Example 2).

Related specifications

HTML 5.1
W3C Working Draft
HTML 5
W3C Recommendation
HTML 4.01
W3C Recommendation

See also

Related articles

HTML

Text

Attributions