Quotation Marks and Apostrophes
Single and double quotation marks are not rendered as curved quotation marks (also known as smart, curly, typographic or book quotation marks).
When entered using the ' and " key, Asciidoctor outputs straight (dumb, vertical, typewriter)
However, by creating a set of backticks (
`) contained within a set of single quotes (
') or double quotes (
"), you can tell Asciidoctor where to output curved quotation marks.
"`What kind of charm?`" Lazarus asked. "`An odoriferous one or a mineral one?`" (1) Kizmet shrugged. "`The note from Olaf's desk says '`wormwood and licorice,`' but these could be normal groceries for werewolves.`" (2)
|1||To output double curved quotes, enclose a word or phrase in a set of double quotes (
|2||To output single curved quotes, enclose a word or phrase in a set of single quotes (
“What kind of charm?” Lazarus asked. “An odoriferous one or a mineral one?”
Kizmet shrugged. “The note from Olaf’s desk says ‘wormwood and licorice,’ but these could be normal groceries for werewolves.”
When entered with the ' key, Asciidoctor renders an apostrophe that is directly preceded and followed by a character, such as in contractions and possessive singular forms, as a curved apostrophe. This inconsistent handling of apostrophes and quotation marks is a hold over from the original AsciiDoc processor. An apostrophe directly bounded by two characters is processed during the replacements substitution phase, not the inline formatting (quotes) phase. This is why an apostrophe directly followed by white space, such as the possessive plural form, is not curved by default.
To render an apostrophe as curved when it is not bound by two characters, mark it as you would a single curved quote.
Olaf had been with the company since the `'60s. His desk overflowed with heaps of paper, apple cores and squeaky toys. We couldn't find Olaf's keyboard. The state of his desk was replicated, in triplicate, across all of the werewolves`' desks.
In the rendered output, note that the plural possessive apostrophe, seen trailing werewolves, is curved, as is the omission apostrophe before 60s.
Olaf had been with the company since the ’60s. His desk overflowed with heaps of paper, apple cores and squeaky toys. We couldn’t find Olaf’s keyboard. The state of his desk was replicated, in triplicate, across all of the werewolves’ desks.
If you don’t want an apostrophe that is bound by two characters to be rendered as curved, escape it by preceding it with a backslash (
The preventing substitutions and passthrough sections detail additional ways to prevent punctuation substitutions.
Olaf\'s desk ...
Olaf's desk …