Punctuation

This section provides punctuation guidelines for writing WordPress documentation.

A note on rendered output

The recommendations in this section apply to source text — what authors type into editors, code, and documentation files. They are intended to keep source consistent, accessible, and easy to edit.

Note that WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. automatically transforms certain punctuation characters in rendered post content via the wptexturize() function. This filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. is applied by default to post titles, content, excerpts, and comments, and converts straight punctuation to typographic equivalents:

  • Straight apostrophes (') become typographic apostrophes ()
  • Straight quotation marks (", ') become curly quotation marks (, , , )
  • Double hyphens (--) become em dashes ()
  • Three periods (...) become ellipses ()

This means readers will see typographically correct punctuation in most user-facing content even when authors write straight characters in the source. Authors should follow the recommendations in this section regardless — wptexturize() handles the rendered output.

s
search
c
compose new post
r
reply
e
edit
t
go to top
j
go to the next post or comment
k
go to the previous post or comment
o
toggle comment visibility
esc
cancel edit post or comment