Last modified: February 28, 2022. Valid as of Hugo version 0.93.0 (with goldmark version 1.4.7).
goldmark Typographer issues
Note, 2022-02-28: Thanks to code contributed by Nate Moore, goldmark v.1.4.7 resolved these problems; Hugo 0.93.0 was the first Hugo release to include that goldmark version.
Here are examples of issues found with the Typographer
extension in the goldmark Markdown parser, which Hugo uses. I hope this will help @yuin
and PR-submitters resolve them; see this comment.
Repo for this site: https://github.com/brycewray/gm-typographer.
For each issue, you’ll see:
- The Markdown
- The correct result (in U.S. English)
- The current goldmark/Typographer result
Closing quotation marks within italics
*"At first, things were not clear."*
Correct:
“At first, things were not clear.”
GM/T result:
“At first, things were not clear.”
Closing quotation marks within boldfacing
**"At first, things were not clear."**
Correct:
“At first, things were not clear.”
GM/T result:
“At first, things were not clear.”
Closing quotation marks within boldfacing and italics
***"At first, things were not clear."***
Correct:
“At first, things were not clear.”
GM/T result:
“At first, things were not clear.”
Plural possessives
John's dog is named Sam. The Smiths' dog is named Rover.
Correct:
John’s dog is named Sam. The Smiths’ dog is named Rover.
GM/T result:
John’s dog is named Sam. The Smiths’ dog is named Rover.
Links within quotation marks and parenthetical phrases
This is not difficult (see "[Introduction to Hugo Templating](https://gohugo.io/templates/introduction/)").
Correct:
This is not difficult (see “Introduction to Hugo Templating”).
GM/T result:
This is not difficult (see “Introduction to Hugo Templating”).
Quotation marks within links
Apple's early Cairo font gave us ["moof" and the "dogcow."](https://www.macworld.com/article/2926184/we-miss-you-clarus-the-dogcow.html)
Correct:
Apple’s early Cairo font gave us “moof” and the “dogcow.”
GM/T result:
Apple’s early Cairo font gave us “moof” and the “dogcow.”
Single closing quotation marks with slang/informalities
"I'm not doin' that," Bill said with emphasis.
Correct:
“I’m not doin’ that,” Bill said with emphasis.
GM/T result:
“I’m not doin’ that,” Bill said with emphasis.
Closing single quotation marks in quotations-within-quotations
Janet said, "When everything is 'breaking news,' nothing is 'breaking news.'"
Correct:
Janet said, “When everything is ‘breaking news,’ nothing is ‘breaking news.’”
GM/T result:
Janet said, “When everything is ‘breaking news,’ nothing is ‘breaking news.’”
Opening single quotation marks for abbreviations
We're talking about the internet --- 'net for short.
Correct:
We’re talking about the internet — ’net for short.
GM/T result:
We’re talking about the internet — ’net for short.
Note: This may be impossible to resolve, since it could cause subsequent issues with the opening quotation marks for nested quotes:
He muttered, "And then she said, 'Hello,' in a shy voice."
Quotation marks next to footnotes
People ask, "Why can't you just change the format?"[^formatChgNote]
Correct:
People ask, “Why can’t you just change the format?”1
GM/T result:
People ask, “Why can’t you just change the format?”1
-
This is a regular footnote. ↩︎