You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
29 lines
1.5 KiB
29 lines
1.5 KiB
4 years ago
|
////
|
||
|
|
Included in:
|
||
|
|
|
||
|
|
- user-manual: text formatting
|
||
|
|
////
|
||
|
|
|
||
|
|
Just as we emphasize certain words and phrases when we speak, we can emphasize them in text with formatting.
|
||
|
|
This formatting, such as bold or monospace, is indicated by surrounding letters, words, or phrases with simple markup.
|
||
|
|
When Asciidoctor processes text enclosed by formatting markup, the markup is replaced by the corresponding HTML or XML tags, depending on your backend, during the <<user-manual#quotes,quotes substitution phase>>.
|
||
|
|
|
||
|
|
.Text formatting versus quotes
|
||
|
|
****
|
||
|
|
The original AsciiDoc processor calls this markup and its related features _quotes_, _quotes substitutions_, and _quoted text_.
|
||
|
|
However, in the Asciidoctor documentation, we refer to the text formatting markup as, you guessed it, text formatting.
|
||
|
|
When you need to control when text formatting is applied to certain blocks, the substitution attribute is still named `quotes`, but we're considering changing this to a more semantic name in a future Asciidoctor version.
|
||
|
|
****
|
||
|
|
|
||
|
|
Continue reading to learn how to format letters, words or phrases with the following styles:
|
||
|
|
|
||
|
|
- [x] bold
|
||
|
|
- [x] italic
|
||
|
|
- [x] curved (smart) quotation marks and apostrophes
|
||
|
|
- [x] subscript and superscript
|
||
|
|
- [x] monospace
|
||
|
|
- [x] highlighted, built-in and custom CSS styles
|
||
|
|
|
||
|
|
CAUTION: You may not always want these symbols to indicate text formatting.
|
||
|
|
In those cases, you'll need to use additional markup to <<user-manual#preventing-substitutions,escape the text formatting markup>>.
|