Basic text styles

The basic styles feature lets you apply the most essential formatting such as bold, italic, underline, strikethrough, subscript, superscript, and code. Coupled with more formatting features, these serve as a base for any WYSIWYG editor toolset.

# Demo

You may apply basic formatting options with toolbar buttons. You can also make use of the autoformatting feature that changes Markdown code to formatted text as you type. Use one of these to format text:

• Bold – Use the bold toolbar button or type **text** or __text__.
• Italic – Use the italic toolbar button or type *text* or _text_.
• Code – Use the code toolbar button or type `text`.
• Strikethrough – Use the strikethrough toolbar button or type ~~text~~.

# Available text styles

Style feature	Command name	Toolbar component name	Output element
Bold	'bold'	'bold'	<strong>bold</strong>
Italic	'italic'	'italic'	<i>italic</i>
Underline	'underline'	'underline'	<u>underline</u>
Strikethrough	'strikethrough'	'strikethrough'	<s>strikethrough</s>
Code	'code'	'code'	<code>code</code>
Subscript	'subscript'	'subscript'	<sub>subscript</sub>
Superscript	'superscript'	'superscript'	<sup>superscript</sup>

# Supported input

By default, each feature can upcast more than one type of content. Here is the full list of elements supported by each feature, either when pasting from the clipboard, loading data on start, or using the data API.

Style feature	Supported input elements
Bold	<strong>, <b>, <* style="font-weight: bold"> (or numeric values that are greater or equal 600)
Italic	<i>, <em>, <* style="font-style: italic">
Underline	<u>, <* style="text-decoration: underline">
Strikethrough	<s>, <del>, <strike>, <* style="text-decoration: line-through">
Code	<code>, <* style="word-wrap: break-word">
Subscript	<sub>, <* style="vertical-align: sub">
Superscript	<sup>, <* style="vertical-align: super">

# Typing around inline code

CKEditor 5 allows for typing both at the inner and outer boundaries of code to make editing easier for the users.

To type inside a code element, move the caret to its (start or end) boundary. As long as the code remains highlighted (by default: less transparent gray), typing and applying formatting will be done within its boundaries:

To type before or after a code element, move the caret to its boundary, then press the Arrow key (→ or ←) once. The code is no longer highlighted and whatever text you type or formatting you apply will not be enclosed by the code element:

# Installation

To add the basic styles features to your editor install the @ckeditor/ckeditor5-basic-styles package:

npm install --save @ckeditor/ckeditor5-basic-styles

And add the plugins which you need to your plugin list. Then, simply configure the toolbar items to make the features available in the user interface.

import { Bold, Code, Italic, Strikethrough, Subscript, Superscript, Underline } from '@ckeditor/ckeditor5-basic-styles';

ClassicEditor
    .create( document.querySelector( '#editor' ), {
        plugins: [ Bold, Italic, Underline, Strikethrough, Code, Subscript, Superscript ],
        toolbar: {
            items: [ 'bold', 'italic', 'underline', 'strikethrough', 'code', 'subscript', 'superscript'  ]
        }
    } )
    .then( /* ... */ )
    .catch( /* ... */ );

# Related features

Check out also these CKEditor 5 features to gain better control over your content style and format:

• Font styles – Easily and efficiently control the font family, size, text or background color.
• Styles – Apply pre-configured styles to existing elements in the editor content.
• Text alignment – Because it does matter whether the content is left, right, centered, or justified.
• Case change – Turn a text fragment or block into uppercase, lowercase, or title case.
• Code blocks – Insert longer, multiline code listings, expanding the inline code style greatly.
• Highlight – Mark important words and passages, aiding a review or drawing attention to specific parts of the content.
• Format painter – Easily copy text formatting and apply it in a different place in the edited document.
• Autoformatting – Format the text on the go with Markdown code.
• Remove format – Easily clean basic text formatting.

# Common API

Each style feature registers a command which can be executed from code. For example, the following snippet will apply the bold style to the current selection in the editor:

editor.execute( 'bold' );

# Contribute

The source code of the feature is available on GitHub at https://github.com/ckeditor/ckeditor5/tree/master/packages/ckeditor5-basic-styles.