Wikipedia:Manual of Style

The Manual of Style (often abbreviated MoS or MOS) is a style guide for all Wikipedia articles. This page and its subpages cover certain style topics (such as punctuation) in full, and presents the key points of others. The subpages also provide detailed guidance on particular topics or subject areas. These are linked in this page's menu, and are listed at the MoS Contents page.

The MoS presents Wikipedia's house style, to help editors produce articles with consistent, clear, and precise language, layout, and formatting. The goal is to make the encyclopedia easier and more intuitive to use. Consistency in language, style, and formatting promotes clarity and cohesion; this is especially important within an article.

Writing should be clear and concise. Plain English works best: avoid ambiguity, jargon, and vague or unnecessarily complex wording.

Where more than one style is acceptable, editors should not change an article from one of those styles to another without a substantial reason. Revert-warring over optional styles is unacceptable.[1] If discussion cannot determine which style to use in an article, defer to the style used by the first major contributor.

Any issues relating to style guidance can be discussed on the MoS talk page. Some of the past discussions that led to decisions on aspects of style guidance are recorded at the MoS register.

Article titles, headings, and sections

Article titles

The title of an article should be based on the Article titles policy. The principal criteria are that a title be recognizable (as a name or description of the topic), natural, sufficiently precise, concise, and consistent with the titles of related articles. If these criteria are in conflict, they need to be balanced against one another.

For formatting guidance, see Article title format. The following points are critical:

The Manual of Style applies to all parts of an article, including the title. See especially punctuation, below. (The policy page Wikipedia:Article titles does not determine punctuation.)

Section organization

An article should begin with an introductory lead section, which does not contain section headings (see Wikipedia:Manual of Style/Lead section). The remainder is divided into sections, each with a section heading (see below) that can be nested in a hierarchy. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading.

If the topic of a section is also covered in more detail in a dedicated article, show this by inserting {{main|Article name}} directly under the section heading (see also Wikipedia:Summary style).

As explained in more detail in Standard appendices and footers, optional appendix and footer sections containing the following lists may appear after the body of the article in the following order:

Other article elements include disambiguation hatnotes (normally placed at the very top of the article) and infoboxes (usually placed before the lead section).

Section headings

Shortcuts:

Headings are produced by typing multiple equal signs. A primary section heading is written ==Title==, a subsection below it is written ===Title===, and so on (a maximum of five levels is possible). Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit window. (Only two or more consecutive blank lines will add more white space in the public appearance of the page.)

The provisions in Article titles (above) generally apply to section headings as well (for example, headings are in sentence case, not title case). The following points apply specifically to section headings:

Before changing a section heading, consider whether you might be breaking existing links to that section. If there are many links to the old section title, create an anchor with that title to ensure that the links still work. Similarly, when linking to a section of an article, leave an invisible comment at that section, specifying the names of the linking articles so that if the title is altered, others can fix the links. For example:

==Evolutionary implications<!--This section is linked from [[Richard Dawkins]] and [[Daniel Dennett]]-->==

National varieties of English

Shortcuts:

The English Wikipedia prefers no major national variety of the language over any other. These varieties (e.g. U.S. English, British English) differ in vocabulary (soccer vs. football), spelling (center vs. centre), and occasionally grammar (see Plurals, below). The following subsections describe how to determine the appropriate variety for an article. (The accepted style of punctuation is covered in the punctuation section, below.)

Consistency within articles

Shortcut:

Although Wikipedia favors no national variety of English, within a given article the conventions of one particular variety should be followed consistently. The exceptions are:

Strong national ties to a topic

Shortcuts:

An article on a topic that has strong ties to a particular English-speaking nation should use the English of that nation. For example:

For articles about modern writers or their works, it is sometimes decided to use the variety of English in which the subject wrote (especially if the writings are quoted). For example, the articles on J. R. R. Tolkien and The Lord of the Rings use British English with Oxford spelling.

This guideline should not be used to claim national ownership of any article; see Wikipedia:Ownership of articles.

Retaining the existing variety

Shortcuts:

In general, disputes over which English variety to use in an article are strongly discouraged. Such debates waste time and engender controversy, mostly without accomplishing anything positive.

When an English variety's consistent usage has been established in an article, it is maintained in the absence of consensus to the contrary. With few exceptions (e.g. when a topic has strong national ties or a term/spelling carries less ambiguity), there is no valid reason for such a change.

When no English variety has been established and discussion cannot resolve the issue, the variety used in the first non-stub revision is considered the default. If no English variety was used consistently, the tie is broken by the first post-stub contributor to introduce text written in a particular English variety. The variety established for use in a given article can be documented by placing the appropriate Varieties of English template on its talk page.

An article should not be edited or renamed simply to switch from one valid use of English to another. Editors who alter an existing variety can be advised of this guideline via the placement of {{subst:uw-lang}} on their talk pages.

Opportunities for commonality

Shortcuts:

Wikipedia tries to find words that are common to all varieties of English. Insisting on a single term or a single usage as the only correct option does not serve the purposes of an international encyclopedia.

Articles such as English plural and American and British English differences provide information on the differences between these major varieties of the language.

Capital letters

Sentence case rather than title case is used in Wikipedia article titles and section headings; see Article titles and Section headings above. For capitalization of list items, see Bulleted and numbered lists. Other points concerning capitalization are summarized below; full information can be found at the MoS page on capital letters.

Do not use capitals for emphasis

Do not use capital letters for emphasis; where wording alone cannot provide the emphasis, use italics.

Incorrect: It is not only a LITTLE (or Little) learning that is dangerous.
Correct: It is not only a little learning that is dangerous.

Capitalization of "The"

Generally do not capitalize the definite article in the middle of a sentence: an article about the United Kingdom (not about The United Kingdom). However there are some conventional exceptions, including most titles of artistic works: Tolkien wrote The Lord of the Rings (but Homer wrote the Odyssey); public transport in The Hague.

For treatment in band and album names, see Wikipedia:Manual of Style/Music#Names (definite article).

Titles of works

The English-language titles of compositions (books and other print works, songs and other audio works, films and other visual media works, paintings and other artworks, etc.), are given in title case, in which every word is given an initial capital except for certain less important words (as detailed at WP:Manual of Style/Capital letters#Composition titles). The first and last words in a title are always capitalized. Capitalization in foreign-language titles varies, even over time within the same language; generally, retain the style of the original.

Correct:: The Unbearable Lightness of Being
Correct:: Hymnus an den heiligen Geist

Titles of people

Religions, deities, philosophies, doctrines

Calendar items

Animals, plants, and other organisms

Shortcuts:

When using scientific names, capitalize the genus but not the species or taxonomic rank below species if present: Berberis darwinii, Erithacus rubecula superbus. No exception is made for proper names forming part of scientific names. Higher taxa (order, family, etc.) are capitalized in Latin (Carnivora, Felidae) but not in their English equivalents (carnivorans, felids).

Common (vernacular) names are given in lower case, except where proper names appear (zebras, mountain maple, gray wolf, but Przewalski's horse). Some editors prefer to capitalize the IOC-published common names of birds (Golden Eagle) in ornithological articles; do not apply this style to other categories. Use a consistent style for common names within an article. Create redirects from alternative capitalization forms of article titles.

General names for groups or types of animals are not capitalized except where they contain a proper name (oak, bottlenose dolphins, rove beetle, Van cat).

Celestial bodies

Compass points

Do not capitalize directions such as north, nor their related forms (We took the northern road), except where they are parts of names (such as Great North Road).

Capitalize names of regions if they have attained proper-name status, including informal conventional names (Southern California; the Western Desert), and derived terms for people (e.g. a Southerner as someone from the Southern United States). Do not capitalize descriptive names for regions that have not attained the status of proper names, such as southern Poland.

(Composite directions may or may not be hyphenated, depending on the style adopted in the article. Southeast Asia and northwest are more common in American English; but South-East Asia and north-west in British English. In cases such as north–south dialogue and east–west orientation an en dash is used; see en dashes, below.)

Institutions

Names of particular institutions are proper nouns and require capitals, but generic words for institutions (university, college, hospital, high school) do not. For example: The university offers programs in arts and sciences, but The University of Delhi offers ....

The word the at the start of a title is usually uncapitalized, but follow the institution's own usage (a degree from the University of Sydney; but researchers at The Ohio State University).

Similar considerations apply to political or geographical units, such as cities and islands: The city has a population of 55,000, but The City of Smithville ... (an official name). (Note also the use of the City to refer to the City of London.)

Abbreviations

Write out both the full version and the abbreviation at first occurrence
the New Democratic Party (NDP) won the 1990 Ontario election with a significant majority, at the first mention of the New Democratic Party; and
the NDP quickly became unpopular with the voters, at a subsequent mention.
Make an exception for very common abbreviations; in most articles they require no expansion (PhD, DNA, USSR).
Incorrect (not a proper noun): We used Digital Scanning (DS) technology
Correct: We used digital scanning (DS) technology
Correct (a proper noun): The film was produced by the British Broadcasting Corporation (BBC)
They first debated the issue in 1992 (at a convention of the New Democratic Party, or NDP)
Plural and possessive forms
Acronyms and initialisms, like other nouns, become plurals by adding -s or -es (they produced three CD-ROMs in the first year; the laptops were produced with three different BIOSes in 2006). As with other nouns, no apostrophe is used unless the form is a possessive.
Periods (full stops) and spaces
US and U.S.
Shortcuts:
In American and Canadian English, U.S. (with periods) is the dominant abbreviation for United States. US (without periods) is more common in most other national forms of English. Some major American guides to style, such as The Chicago Manual of Style (16th ed.), now deprecate U.S. and favor US. Use of periods for initialisms should be consistent within any given article, and congruent with the variety of English used by that article. In longer abbreviations incorporating the country's initials (USN, USAF), periods are not used. When the United States is mentioned with one or more other countries in the same sentence, U.S. or US may be too informal, especially at the first mention or as a noun instead of an adjective (France and the United States, not France and the U.S.). Do not use the spaced U. S., nor the archaic U.S. of A., except when quoting. Do not use U.S.A. or USA, except in a quotation or as part of a proper name (Team USA).
Circa
To indicate approximately, the unitalicised abbreviation c. (followed by a space) is preferred over circa, ca., or approx.
Do not use unwarranted abbreviations
Avoid abbreviations when they might confuse the reader, interrupt the flow, or appear informal. For example, do not use approx. for approximate or approximately, except to reduce the width of an infobox or a table of data, or in a technical passage in which the term occurs many times.
See also Wikipedia:Manual of Style/Dates and numbers for when to abbreviate units of measurement.
Do not invent abbreviations or acronyms
Generally avoid making up new abbreviations, especially acronyms (World Union of Billiards is good as a translation of Union Mondiale de Billard, but neither it nor the reduction WUB is used by the organization; so use the original name and its official abbreviation, UMB). If it is necessary to abbreviate a heading in a wide table of data, use widely recognized initialisms (for United States gross national product use US and GNP, with a link if the term has not already been written out: US GNP; do not use the made-up initialism USGNP).
HTML elements
The <abbr> element can be used for abbreviations and acronyms: <abbr title="HyperText Markup Language">HTML</abbr> generates HTML. The software that Wikipedia runs on does not support <acronym>, as it is obsolete in the latest version of HTML.

Ampersand

Shortcuts:

The ampersand (&) substitutes for the word and (it was a form of Latin et). In normal text, and should be used instead: January 1 and 2, not January 1 & 2. Retain ampersands in titles of works or organizations, such as The Tom & Jerry Show or AT&T. Ampersands may be used with consistency and discretion in tables, infoboxes, and similar contexts where space is limited. Modern editions of old texts routinely replace ampersands with and (just as they replace other disused glyphs, ligatures, and abbreviations); so an article's quotations may be cautiously modified, especially for consistency where different editions are quoted. (For similar allowable modifications see Quotations, below.)

Italics

Emphasis
Italics may be used sparingly to emphasize words in sentences (whereas boldface is normally not used for this purpose). Generally, the more highlighting in an article, the less its effectiveness.
Use italics when introducing terms, or distinguishing among them (The enamel organ is composed of the outer enamel epithelium, inner enamel epithelium, stellate reticulum, and stratum intermedium).
Titles
Use italics for the titles of works of literature and art, such as books, pamphlets, films (including short films), television series, music albums, and paintings. The titles of articles, chapters, songs, television episodes, and other short works are not italicized; they are enclosed in double quotation marks.
Italics are not used for major revered religious works (the Bible, the Qur'an, the Talmud).
Words as words
Use italics when mentioning a word or letter (see Use–mention distinction) or a string of words up to one full sentence (the term panning is derived from panorama, a word coined in 1787; the most commonly used letter in English is e). When a whole sentence is mentioned, quotation marks may be used instead, with consistency (The preposition in She sat on the chair is on; or The preposition in "She sat on the chair" is "on"). Mentioning (to discuss such features as grammar, wording, and punctuation) is different from quoting (in which something is usually expressed on behalf of a quoted source).
Foreign words
Use italics for phrases in other languages and for isolated foreign words that are not common in everyday English. Proper names (such as place names) in other languages, however, are not usually italicized.
Scientific names
Use italics for the scientific names of plants, animals and other organisms at the genus level and below (italicize Panthera leo but not Felidae). The hybrid sign is not italicized (Rosa ×damascena), nor is the "connecting term" required in three-part botanical names (Rosa gallica subsp. officinalis).
Quotations in italics
For quotations, use only quotation marks (for short quotations) or block quoting (for long ones), not italics. (See Quotations below.) This means that (1) a quotation is not italicized inside quotation marks or a block quote just because it is a quotation, and (2) italics are no substitute for proper quotation formatting. One way to distinguish long block quotes from ordinary text is to use {{quotation}}, which will box the text. Citation links may not work within such templates; if so, it may be necessary to use {{quote}}.
Italics within quotations
Use italics within quotations if they are already in the source material. When adding italics on Wikipedia, add an editorial note [emphasis added] after the quotation.

"Now cracks a noble heart. Good night sweet prince: And flights of angels sing thee to thy rest" [emphasis added].

If the source has used italics (or some other styling) for emphasis and this is not otherwise evident, the editorial note [emphasis in original] should appear after the quotation.
Effect on nearby punctuation
Italicize only the elements of the sentence affected by the emphasis. Do not italicize surrounding punctuation.
Incorrect:    What are we to make of that?
Correct: What are we to make of that?
      (Note the difference between ? and ?. The question mark applies to the whole sentence, not just to the emphasized that.)
Correct: Four of Patrick White's most famous novels are A Fringe of Leaves, The Aunt's Story, Voss, and The Tree of Man.
(The commas, the period, and the word and are not italicized.)
Italicized links
The italics markup must be outside the link markup, or the link will not work; however, internal italicization can be used in piped links.
Incorrect:    The opera [[''Turandot'']] is his best.
Correct: The opera ''[[Turandot]]'' is his best.
Correct: The [[USS Adder (SS-3)|USS ''Adder'' (SS-3)]] was a submarine.

Non-breaking spaces

Shortcuts:

A non-breaking space (also known as a hard space) is recommended to prevent the end-of-line displacement of elements that could be awkward at the beginning of a new line.

Technical information

Use

It is advisable to use a non-breaking space to prevent the end-of-line displacement of elements that would be awkward at the beginning of a new line:

Quotations

Shortcuts:

Minimal change

Preserve the original text, spelling, and punctuation. Where there is a good reason to make a change, insert an explanation within square brackets (for example, [her father] replacing him, where the context explaining him is omitted in the quotation). If there is a significant error in the original statement, use [sic], or the template {{sic}} (which produces [sic]), to show that the error was not made in transcription. Trivial spelling or typographical errors should be silently corrected (for example, correct ommission to omission, harasssment to harassment)—unless the slip is textually important.

Use ellipses to indicate omissions from quoted text. Legitimate omissions include extraneous, irrelevant, or parenthetical words, and unintelligible speech (umm, and hmm). Do not omit text where doing so would remove important context or alter the meaning of the text. When a vulgarity or obscenity is quoted, it should appear exactly as it does in the cited source; words should never be bowdlerized by replacing letters with dashes, asterisks, or other symbols. In carrying over such an alteration from a quoted source, [sic] may be used to indicate that the transcription is exact.

Allowable typographical changes

Although the requirement of minimal change is strict, a few purely typographical elements of quoted text should be adapted to English Wikipedia's conventions without comment. This practice of conforming typographical styling to a publication's own "house style" is universal. Allowable typographical alterations include these:

Quotations within quotations

When a quotation includes another quotation (and so on), start with double quote marks outermost, and, working inward, alternate single with double quote marks ("She accepted his statement that 'Voltaire never said "I disapprove of what you say, but I will defend to the death your right to say it."'", with three levels of quotation). Adjacent quote marks, as at the end of that last example, can be difficult to read ("'") unless kerned apart slightly with CSS; the {{" '}}, {{' "}}, and {{" ' "}} templates will accomplish this; the example above is achieved by typing this: ... your right to say it.{{" ' "}}.

Attribution

The author of a quote of a full sentence or more should be named; this is done in the main text and not in a footnote. However, attribution is unnecessary with quotations that are clearly from the person discussed in the article or section. When preceding a quotation with its attribution, avoid characterizing it in a biased manner.

Linking

As much as possible, avoid linking from within quotes, which may clutter the quotation, violate the principle of leaving quotations unchanged, and mislead or confuse the reader.

Two alternatives are available:

Block quotations

Format a long quote (more than about 40 words or a few hundred characters, or consisting of more than one paragraph, regardless of length) as a block quotation, which Wikimedia's software will indent from both margins. Do not enclose block quotations in quotation marks (and especially avoid decorative quotation marks in normal use, such as those provided by the {{cquote}} template, which are reserved for pull quotes). Block quotations using a colored background are also discouraged. Block quotations can be enclosed between a pair of <blockquote>...</blockquote> HTML tags; or use {{quote}}.

Poetry, lyrics, and other formatted text may be quoted inline if they are short, or presented in a block quotation. If inline, line breaks should be indicated by /, and paragraph or stanza breaks by //. Wikipedia's MediaWiki software does not normally render line breaks inside a <blockquote>, but the <poem> extension can be used to preserve them:

<blockquote><poem>
Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore—
While I nodded, nearly napping, suddenly there came a tapping,
As of some one gently rapping, rapping at my chamber door.
"'Tis some visiter," I muttered, "tapping at my chamber door—
            Only this and nothing more."
</poem></blockquote>

This will result in the following, indented on both sides (it may also be in a smaller font, depending on browser software):

Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore—
While I nodded, nearly napping, suddenly there came a tapping,
As of some one gently rapping, rapping at my chamber door.
"'Tis some visiter," I muttered, "tapping at my chamber door—
            Only this and nothing more."

The {{quote}} template retains line breaks but not leading spaces (use hard spaces, &nbsp;, instead), and adds a parameter for the attribution.

Foreign-language quotations

Quotations from foreign-language sources should appear in translation. Quotations that are translations should be explicitly distinguished from those that are not. Indicate the original source of a translation (if it is available, and not first published within Wikipedia), and the original language (if that is not clear from the context).

If the original, untranslated text is available, provide a reference for it or include it, as appropriate.

Punctuation

Shortcuts:

Apostrophes

Quotation marks

Shortcut:

The term quotation in the material below also includes other uses of quotation marks such as those for titles of songs, chapters, episodes, unattributable aphorisms, literal strings, "scare-quoted" passages, and constructed examples.

Double or single
Enclose quotations with double quotation marks (Bob said, "Jim ate the apple."). Enclose quotations inside quotations with single quotation marks (Bob said, "Did Jim say 'I ate the apple' after he left?"). This is by far the dominant convention in current practice; see other reasons, below.
  • There are some conventional codified exceptions, such as single quotation marks for plant cultivars (Malus domestica 'Golden Delicious'); see WP:FLORA.
Article openings
When the title of an article appearing in the lead paragraph requires quotation marks (for example, the title of a song or poem), the quotation marks should not be in boldface, as they are not part of the title:
Correct: "Jabberwocky" is a nonsense poem by Lewis Carroll.
Block quotes
As already noted above, we use quotation marks or block quotes (not both) to distinguish long quotations from other text. Multiparagraph quotations are always block-quoted. The quotations must be precise and exactly as in the source (except for certain allowable typographical changes, also noted above). The source should be cited clearly and precisely to enable readers to locate the text in question, and to quote it accurately themselves from Wikipedia.
Quotation characters
Do not use grave and acute accents or backticks (`text´) as quotation marks (or as apostrophes).
There are two possible methods for rendering quotation marks at Wikipedia (that is, the glyphs, displayed with emphasis here, for clarity):
  • Typewriter or straight style: "text", 'text'. Recommended at Wikipedia.
  • Typographic or curly style: text, text. Not recommended at Wikipedia.
Whenever quotation marks or apostrophes appear in article titles, make a redirect from the same title but using the alternative glyphs.
Reasons to prefer straight quotation marks and apostrophes (and double quotation marks)

Typographical, or curly, quotation marks and apostrophes might be read more efficiently; and many think they look more professional. But for practical reasons the straight versions are recommended, and double rather than single quotation marks as primary.

She wrote that 'Cleanthes' differs from the others', but neither opinion may represent Hume's'; ... (slows the reader down)
She wrote that "Cleanthes' differs from the others', but neither opinion may represent Hume's"; ... (clearer)

Punctuation inside or outside

Shortcuts:

On Wikipedia, place all punctuation marks inside the quotation marks if they are part of the quoted material and outside if they are not. This practice is sometimes referred to as logical quotation. It is used here because it is deemed by Wikipedia consensus to be more in keeping with the principle of minimal change. This punctuation system does not require placing final periods and commas outside the quotation marks all the time, but rather maintaining their original positions in (or absence from) the quoted material.

Correct: Arthur said, "The situation is deplorable and unacceptable."
(The period is known to be in the source.)
Correct: Arthur said that the situation was "deplorable".
(The period is known not to be in the source, its presence in the source is uncertain, or its coverage within the quotation is considered unnecessary.)
Correct: Martha asked, "Are you coming?"
(The question mark belongs inside because the quoted text itself was a question.)
Correct: Did Martha say, "Come with me"?
(The very quote is being questioned, so the question mark belongs outside; any punctuation at the end of the original quote is omitted.)
When a quoted sentence fragment ends in a period, some judgment is required: if the fragment communicates a complete sentence, the period can be placed inside. The period should be omitted if the quotation is in the middle of a sentence.
Correct: Martha said, "Come with me", and they did.
If the sequence of juxtaposed punctuation marks seems distracting or untidy, try an acceptable alternative.
Correct: Martha said, "Come with me" (and they did).

Brackets and parentheses

These rules apply to both round brackets ( ( ) ), often called parentheses, and square brackets ( [ ] ).

If a sentence contains a bracketed phrase, place the sentence punctuation outside the brackets (as shown here). However, where one or more sentences are wholly inside brackets, place their punctuation inside the brackets. (For examples, see Sentences and brackets, below.) There should be no space next to the inner side of a bracket. An opening bracket should be preceded by a space, except in unusual cases; for example, when it is preceded by an opening quotation mark, another opening bracket, or a portion of a word:

He rose to address the meeting: "(Ahem) ... Ladies and gentlemen, welcome!"

Only the royal characters in the play ([Prince] Hamlet and his family) habitually speak in blank verse.

We journeyed on the Inter[continental].

There should be a space after a closing bracket, except where a punctuation mark follows (though a spaced dash would still be spaced after a closing bracket), and in unusual cases similar to those listed for opening brackets.

If sets of brackets are nested, use different types for adjacent levels of nesting; for two levels, it is customary to have square brackets appear within round brackets. This is often a sign of excessively convoluted expression; it is often better to recast, linking the thoughts with commas, semicolons, colons, or dashes.

Avoid adjacent sets of brackets. Either put the parenthetic phrases in one set separated by commas, or rewrite the sentence:

Incorrect:    Nikifor Grigoriev (c. 1885–1919) (also known as Matviy Hryhoriyiv) was a Ukrainian insurgent leader.
Correct: Nikifor Grigoriev (c. 1885–1919), also known as Matviy Hryhoriyiv, was a Ukrainian insurgent leader.
Correct: Nikifor Grigoriev (c. 1885–1919) was a Ukrainian insurgent leader. He was also known as Matviy Hryhoriyiv.

Square brackets are used to indicate editorial replacements and insertions within quotations, though this should never alter the intended meaning. They serve three main purposes:

Sentences and brackets

She refused all requests (except for basics such as food, medicine, etc.).
"[Principal Skinner] already told me that", he objected.
That is preferable to this, which is potentially ambiguous:
"He already told me that", he objected.
But even here consider an addition rather than a replacement of text:
"He [Principal Skinner] already told me that", he objected.
Alexander then conquered (who would have believed it?) most of the known world.
Clare demanded that he drive (she knew he hated driving) to the supermarket.
It is often clearer to separate the thoughts into separate sentences or clauses:
Alexander then conquered most of the known world. Who would have believed it?
Clare demanded that he drive to the supermarket; she knew he hated driving.

Brackets and linking

If the text of a link needs to contain one or more square brackets, "escape" these using <nowiki>...</nowiki> tags or the appropriate numerical character reference.

He said "I spoke to [[John Doe|John &#91;Doe&#93;]] that morning."

He said "I spoke to John [Doe] that morning."

*Branwen, Gwern (2009). [http://lists.wikimedia.org/pipermail/wikien-l/2009-November/105182.html <nowiki>[WikiEN-l]</nowiki> Chinese start caring about copyright].

If a URL itself contains square brackets, the wiki-text should use the url-encoded form: something.php?query=%5Bxxx%5Dyyy&whatever=else rather than ... query=[xxx]yyy& ... to avoid truncation of the link text after "xxx". Of course, this issue only arises for external links as MediaWiki software forbids square brackets in page titles.

Ellipses

Shortcuts:

An ellipsis (plural ellipses) is an omission of material from quoted text; or some other omission, perhaps of the end of a sentence, often used in a printed record of conversation. The ellipsis is represented by ellipsis points: a set of three dots.

Style
Ellipsis points, or ellipses, have traditionally been implemented in three ways:
  • Three unspaced periods (...). This is the easiest way, and gives a predictable appearance in HTML. Recommended.
  • Pre-composed ellipsis character (); generated with the &hellip; character entity, or as a literal "…". This is harder to input and edit, and too small in some fonts. Not recommended.
  • Three spaced periods (. . .). This is an older style that is unnecessarily wide and requires non-breaking spaces to keep it from breaking at the end of a line. Not recommended.
Function and implementation
Use an ellipsis if material is omitted in the course of a quotation, unless square brackets are used to gloss the quotation (see above, and points below).
  • Put a space on each side of an ellipsis ("France, Germany, ... and Belgium"), except that there should be no space between an ellipsis and:
    • a quotation mark directly following the ellipsis ("France, Germany, and Belgium ...").
    • any (round, square, curly, etc.) bracket, where the ellipsis is on the inside ("France, Germany (but not Berlin, Munich, ...), and Belgium").
    • sentence-final punctuation, or a colon, semicolon, or comma (all rare), directly following the ellipsis ("Are we going to France ...?").
  • Only place terminal punctuation after an ellipsis if it is textually important (as is often the case with exclamation marks and question marks, and rarely with periods).
  • Use non-breaking spaces (&nbsp;) only as needed to prevent improper line breaks, for example:
    • To keep a quotation mark (and any adjacent punctuation) from being separated from the start or end of the quotation ("...&nbsp;we are still worried"; "Are we going to France&nbsp;...?").
    • To keep the ellipsis from wrapping to the next line ("France, Germany,&nbsp;... and Belgium"; "France, Germany,&nbsp;...&nbsp;and Belgium").
Pause or suspension of speech
Three periods (loosely also called ellipsis points) are occasionally used to represent a pause in or suspense of speech, in which case the punctuation is retained in its original form (Virginia's startled reply was: "Could he ...? No, I cannot believe it!"). Avoid this usage on Wikipedia, except in direct quotations.
With square brackets
An ellipsis does not normally need square brackets around it, because its function is usually obvious—especially if the guidelines above are followed. Square brackets, however, may optionally be used for precision, to make it clear that the ellipsis is not itself quoted; this is usually only necessary if the quoted passage also uses three periods in it to indicate a pause or suspension. The ellipsis should follow exactly the principles given above, but with square brackets inserted immediately before and after it (Her long rant continued: "How do I feel? How do you think I ... look, this has gone far enough! [...] I want to go home!").

Commas

Shortcuts:

Commas are the most frequently used marks in punctuation. They can also be the most difficult to use well. Some important points are made in the Semicolons section below. Other points:

Incorrect: Burke and Wills, fed by local Aborigines (on beans, fish, and "ngardu") survived for a few months.
Correct:    Burke and Wills, fed by local Aborigines (on beans, fish, and "ngardu"), survived for a few months.
Incorrect: She said, "punctuation styles on Wikipedia change too often," and made other complaints.
Correct:    She said, "punctuation styles on Wikipedia change too often", and made other complaints.
Awkward: Mozart was, along with the Haydns, both Joseph and Michael, and also Beethoven, one of Schubert's heroes.
Much better:    Schubert's heroes included Mozart, Beethoven, and Joseph and Michael Haydn.

Serial commas

Shortcuts:

A serial comma (also known as an Oxford comma or a Harvard comma) is a comma used immediately before a conjunction (and or or, sometimes nor) in a list of three or more items: the phrase ham, chips, and eggs includes a serial comma, while the variant ham, chips and eggs omits it. Editors may use either convention on Wikipedia so long as each article is consistent within itself. However, there are some times when the serial comma can create or remove confusion:

Sometimes omitting the comma can lead to an ambiguous sentence, as in this example: The author thanked her parents, Sinéad O'Connor and President Obama, which may list either four people (the two parents and the two people named) or two people (O'Connor and Obama, who are the parents).

Including the comma can also cause ambiguity, as in this example: The author thanked her mother, Sinéad O'Connor, and President Obama, which may list either two people (O'Connor, who is the mother, and Obama) or three people (the first being the mother, the second O'Connor, and the third Obama).

In such cases of ambiguity, there are three ways to clarify:

Recasting example one:

Recasting example two:

Colons

A colon (:) informs the reader that what comes after it demonstrates, explains, or modifies what has come before, or is a list of items that has just been introduced. The items in such a list may be separated by commas; or, if they are more complex and perhaps themselves contain commas, the items should be separated by semicolons:

We visited several tourist attractions: the Leaning Tower of Pisa, which I thought could fall at any moment; the Bridge of Sighs; the supposed birthplace of Petrarch, or at least the first known house in which he lived; and so many more.

A colon may also be used to introduce direct speech enclosed within quotation marks (see above).

In most cases a colon works best with a complete grammatical sentence before it. There are exceptional cases, such as those where the colon introduces items set off in new lines like the very next colon here. Examples:

Correct: He attempted it in two years: 1941 and 1943.
Incorrect:    The years he attempted it included: 1941 and 1943.
Correct (special case):    Spanish, Portuguese, French: these, with a few others, are the West Romance languages.

Sometimes, more in American than British usage, the word following a colon is capitalized, if that word effectively begins a new grammatical sentence, and especially if the colon serves to introduce more than one sentence:

The argument is easily stated: We have been given only three tickets. There are four of us here: you, the twins, and me. The twins are inseparable. Therefore, you or I will have to stay home.

No sentence should contain more than one colon. There should never be a hyphen or a dash immediately following a colon. Only a single space follows a colon.

Semicolons

A semicolon (;) is sometimes an alternative to a full stop (period), enabling related material to be kept in the same sentence; it marks a more decisive division in a sentence than a comma. If the semicolon separates clauses, normally each clause must be independent (meaning that it could stand on its own as a sentence); often, only a comma or only a semicolon will be correct in a given sentence.

Correct: Though he had been here before, I did not recognize him.
Incorrect:    Though he had been here before; I did not recognize him.

Above, "Though he had been here before" cannot stand on its own as a sentence, and therefore is not an independent clause.

Correct: Oranges are an acid fruit; bananas are classified as alkaline.
Incorrect:    Oranges are an acid fruit, bananas are classified as alkaline.

This incorrect use of a comma between two independent clauses is known as a comma splice; however, in very rare cases, a comma may be used where a semicolon would seem to be called for:

Accepted: "Life is short, art is long." (citing a brief aphorism; see Ars longa, vita brevis)
Accepted: "I have studied it, you have not." (reporting brisk conversation, like this reply of Newton's)

A semicolon does not force a capital letter in the word that follows it.

A sentence may contain several semicolons, especially when the clauses are parallel; multiple unrelated semicolons are often signs that the sentence should be divided into shorter sentences, or otherwise refashioned.

Unwieldy: Oranges are an acid fruit; bananas are classified as alkaline; pears are close to neutral; these distinctions are rarely discussed.
One better way:    Oranges are an acid fruit, bananas are alkaline, and pears are close to neutral; these distinctions are rarely discussed.

Semicolon before "however"

Shortcuts:

The meaning of a sentence containing a trailing clause that starts with the word "however" depends on the punctuation preceding that word. A common error is to use the wrong punctuation, thereby changing the meaning to one not intended.

If used with the same meaning as "nevertheless", the word "however" should be preceded by a semicolon and followed by a comma. Example:

It was obvious they could not convert these people; however, they tried.
Meaning: It was obvious they could not convert these people. Nevertheless, they tried.

If the word "however" in the sentence means "in whatever manner", or "regardless of how", it may be preceded by a comma but not by a semicolon, and should not be followed by punctuation. Example:

It was obvious they could not convert these people, however they tried.
Meaning: It was obvious they could not convert these people, regardless of how they tried.

In the first case, the clause that starts with "however" cannot be swapped with the first clause; in the second case this can be done without change of meaning:

However they tried, it was obvious they could not convert these people.
Meaning: Regardless of how hard they tried, it was obvious they could not convert these people.

If the two clauses cannot be swapped, a semicolon is required.

A sentence or clause can also contain the word "however" in the middle if it was moved there from the front. In that case it can be changed to "though", and it is not the start of a clause; in this use the word may be enclosed between commas. Example:

He did not know, however, that the venue had been changed at the last minute.
Meaning: However, he did not know that the venue had been changed at the last minute.

Hyphens

Shortcuts:

Hyphens (-) indicate conjunction. There are three main uses.

  1. To distinguish between homographs (re-dress means dress again, but redress means remedy or set right).
  2. To link certain prefixes with their main word (non-linear, sub-section, super-achiever).
    • There is a clear trend to join both elements in all varieties of English (subsection, nonlinear), particularly in American English. British English tends to hyphenate when the letters brought into contact are the same (non-negotiable, sub-basement) or are vowels (pre-industrial), or where a word is uncommon (co-proposed, re-target) or may be misread (sub-era, not subera). American English reflects the same factors, but tends to close up without a hyphen when possible. Consult a good dictionary, and see National varieties of English above.
  3. To link related terms in compound modifiers:[3]
    • Hyphens can help with ease of reading (face-to-face discussion, hard-boiled egg); where non-experts are part of the readership, a hyphen is particularly useful in long noun phrases, such as those in Wikipedia's scientific articles: gas-phase reaction dynamics. However, hyphens are never inserted into proper-name-based compounds (Middle Eastern cuisine, not Middle-Eastern cuisine).
    • A hyphen can help to disambiguate (little-celebrated paintings is not a reference to little paintings; a government-monitoring program is a program that monitors the government, whereas a government monitoring program is a government program that monitors something else).
    • Many compounds that are hyphenated when used attributively (before the noun they qualify: a light-blue handbag), are not hyphenated when used predicatively (separated from the noun: the handbag was light blue). Hyphenation also occurs in bird names, such as Great Black-backed Gull, and in proper names, such as Trois-Rivières. Where otherwise there would be a loss of clarity, the hyphen may be used in the predicative case as well (hand-fed turkeys, the turkeys were hand-fed).
    • A hyphen is not used after a standard -ly adverb (a newly available home, a wholly owned subsidiary) unless part of a larger compound (a slowly-but-surely strategy). A few words ending in -ly function as both adjectives and adverbs (a kindly-looking teacher; a kindly provided facility). Some such dual-purpose words (like early, only, northerly) are not standard -ly adverbs, since they are not formed by addition of -ly to an independent current-English adjective. These need careful treatment: Early flowering plants appeared around 130 million years ago, but Early-flowering plants risk damage from winter frosts; northerly-situated islands.
    • A hyphen is normally used when the adverb well precedes a participle used attributively (a well-meaning gesture; but normally a very well managed firm, since well itself is modified); and even predicatively, if well is necessary to, or alters, the sense of the adjective rather than simply intensifying it (the gesture was well-meaning, the child was well-behaved, but the floor was well polished).
    • In some cases, like diode–transistor logic, the independent status of the linked elements requires an en dash instead of a hyphen. See En dashes below.
    • A hanging hyphen is used when two compound modifiers are separated (two- and three-digit numbers, a ten-car or -truck convoy, sloping right- or leftward, but better is sloping rightward or leftward).
    • Values and units used as compound modifiers are hyphenated only where the unit is given as a whole word; when the unit symbol is used, it is separated from the number by a non-breaking space (&nbsp;).
Incorrect: 9-mm gap
Correct: 9 mm gap (entered as 9&nbsp;mm gap)
Incorrect:    9 millimetre gap
Correct: 9-millimetre gap
Correct: 12-hour shift
Correct: 12 h shift

Multi-hyphenated items: It is often possible to avoid multi-word hyphenated modifiers by rewording (a four-CD soundtrack album may be easier to read as a soundtrack album of four CDs). This is particularly important where converted units are involved (the 6-hectare-limit (14.8-acre-limit) rule might be possible as the rule imposing a limit of 6 hectares (14.8 acres), and the ungainly 4.9-mile (7.9 km) -long tributary as simply 4.9-mile (7.9 km) tributary).

For optional hyphenation of compound points of the compass such as southwest/south-west, see Compass points above.

Spacing: A hyphen is never followed or preceded by a space, except when hanging (see above) or when used to display parts of words independently, such as the prefix sub- and the suffix -less.

Image filenames and redirects: Image filenames are not part of encyclopedic content; they're tools. They are most useful tools if they can be readily typed, so they always use hyphens instead of dashes. Similarly, article titles with dashes should have a corresponding redirect from the title with hyphens: for example, Michelson-Morley experiment redirects to Michelson–Morley experiment, as the latter title, while correct, is harder to search for.

Non-breaking A non-breaking hyphen can be created by using the HTML code &#8209;.

Hyphenation involves many subtleties that cannot be covered here; the rules and examples presented above illustrate the broad principles that inform current usage.

Dashes

Shortcuts:

Two forms of dash are used on Wikipedia: en dash () and em dash (). Type them in as &ndash; (–) and &mdash; (—) or click on them to the right of the "Insert" tab under the edit window; or see How to make dashes.

Sources use dashes in varying ways, but for consistency and clarity Wikipedia adopts the following principles.

Punctuating a sentence (em or en dashes)

Shortcuts:

Dashes are often used to mark divisions within a sentence: in pairs (parenthetical dashes, instead of parentheses or pairs of commas); or singly (perhaps instead of a colon). They may also indicate an abrupt stop or interruption, in reporting direct speech.

There are two options. Use one or the other consistently in an article.

1. Unspaced em dash

Or:

2. Spaced en dash

Do not use spaced em dashes.

Dashes can clarify the sentence structure when there are already commas or parentheses, or both.

Use dashes sparingly. More than two in a single sentence makes the structure unclear; it takes time for the reader to see which dashes, if any, form a pair.

En dashes: other uses

Shortcuts:

The en dash (–) has other roles, beyond its use as a sentence-punctuating dash (see immediately above). It is often analogous to the hyphen (see the section above), which joins components more strongly than the en dash; or the slash (see the section below), which separates alternatives more definitely. Consider the exact meaning when choosing which to use.

1. In ranges that might otherwise be expressed with to or through

Do not mix en dashes with prepositions like between and from.

If negative values are involved, an en dash might be confusing. Use words instead.

The en dash in a range is always unspaced, except when the endpoints of the range already include at least one space.

2. In compounds when the connection might otherwise be expressed with to, versus, and, or between

Here the relationship is thought of as parallel, symmetric, equal, oppositional, or at least involving separate or independent elements. The components may be nouns, adjectives, verbs, or any other independent part of speech. Often if the components are reversed there would be little change of meaning.

A slash or some other alternative may occasionally be better to express a ratio, especially in technical contexts (see Slashes below).

An en dash is not used for a hyphenated personal name.

An en dash is used for the names of two or more people in a compound.

By default, follow the dominant convention that a hyphen is used in compounded proper names of single entities, not an en dash.

The en dash in all of the compounds above is unspaced.

3. Instead of a hyphen, when applying a prefix (but not a suffix) to a compound that includes a space

Use this punctuation when there are compelling grounds for retaining the construction. For example, from a speech that is simply transcribed and cannot be re-worded; or in a heading where it has been judged most natural as a common name. Otherwise recasting is better.

The en dash in all of the compounds above is unspaced.

4. To separate items in certain lists

Spaced en dashes are used within parts of certain lists. Here are two examples:

Other dashes

Do not use substitutes for em or en dashes, such as the combination of two hyphens (--). These were typewriter approximations.

Slashes

Shortcuts:

Generally avoid joining two words by a slash, also known as a forward slash or solidus ( / ). It suggests that the two are related, but does not specify how. It is often also unclear how the construct would be read aloud. Replace with clearer wording.

An example: The parent/instructor must be present at all times. Must both be present? (Then write the parent and the instructor.) Must at least one be present? (Then write the parent or the instructor.) Are they the same person? (Use a hyphen: the parent-instructor.)

In circumstances involving a distinction or disjunction, the en dash (see above) is usually preferable to the slash: the digital–analog distinction.

An unspaced slash may be used:

A spaced slash may be used:

Spaced slashes should be coded with a leading non-breaking space and a trailing normal space, as in x&nbsp;/ y (which renders as x / y), to prevent improper line breaks.

Do not use the backslash character ( \ ) in place of a slash.

Prefer the division operator ( ÷ ) to ( / ) when representing elementary arithmetic in general text: 10 ÷ 2 = 5. In more advanced mathematical formulas, a vinculum or slash is preferred: \textstyle\frac{x^n}{n!} or xn/n!. (See Wikipedia:Manual of Style/Dates and numbers#Common mathematical symbols and Help:Displaying a formula.)

And/or

Shortcuts:

Avoid the construct and/or on Wikipedia. In general, where it is important to mark an inclusive or, use x or y, or both, rather than x and/or y. For an exclusive or, use either x or y, and optionally add but not both, if it is necessary to stress the exclusivity.

Where more than two possibilities are presented, from which a combination is to be selected, it is even less desirable to use and/or. With two possibilities, at least the intention is clear; but with more than two it may not be. Instead of x, y, and/or z, use an appropriate alternative, such as one or more of x, y, and z; some or all of x, y, and z.

Sometimes or is ambiguous in another way: Wild dogs, or dingoes, inhabit this stretch of land. Are wild dogs and dingoes the same or different? For one case write: wild dogs (dingoes) inhabit ... or wild dogs, also known as dingoes, inhabit ... (meaning dingoes are wild dogs); for the other case write: either wild dogs or dingoes inhabit ....

Number signs

Shortcuts:
Incorrect:    Her album reached #1 in the UK album charts.
Correct: Her album reached No. 1 in the UK album charts.

An exception is issue numbers of comic books, which unlike for other periodicals are given in general text in the form #1, unless a volume is also given, like Volume 2, Number 7 or Vol. 2, No. 7.

Terminal punctuation

Shortcuts:

Spacing

Shortcut:

In normal text, never put a space before a comma, a semicolon, a colon, or a terminal punctuation mark (even in quoted material; see Allowable typographical changes, above). Put a space after these, unless they end a paragraph or are followed by a closing parenthesis, quotation mark, or similar.

Spaces following terminal punctuation

The number of spaces following the terminal punctuation of a sentence in the wiki markup makes no difference on Wikipedia; the MediaWiki software condenses any number of spaces to just one when rendering the page (see Sentence spacing). For this reason, editors may use any spacing style they prefer on Wikipedia. Multiple spacing styles may coexist in the same article, and adding or removing a double space is sometimes used as a dummy edit.

Consecutive punctuation marks

Shortcut:

Where a proper noun that includes terminal punctuation ends a sentence, do not add a second terminal punctuation mark. Where such a noun occurs mid-sentence, punctuation may be added.

Incorrect: Slovak returned to the Red Hot Chili Peppers in 1985 after growing tired of What Is This?.
Correct: Slovak returned to the Red Hot Chili Peppers in 1985 after growing tired of What Is This?
Correct: Slovak, growing tired of What Is This?, returned to the Red Hot Chili Peppers in 1985.

Punctuation and footnotes

Shortcuts:

Footnotes (created by use of <ref>...</ref> tags) can be used in articles to add explanatory notes, and are most commonly used to add references (see Citing sources). <ref> tags should immediately follow the text to which they refer, with no space before the tag. When they coincide with punctuation, the tag is placed immediately after the punctuation.[4] Multiple tags should have no space between them.

Exceptions: <ref> tags are placed before, not after, dashes; and where a reference or other footnote applies only to material within a parenthetical phrase, placing the tag within the closing parenthesis may be appropriate.

(If those examples were actually used, the markers [10], [11], etc. would link to notes in the list of footnotes or references at the end of the article, usually created with a {{reflist}} template.)

Punctuation after formulae

A sentence that ends with a formula should have terminal punctuation (period, exclamation mark, or question mark) after the formula. Within a sentence, other punctuation (such as comma or colon) is used after a formula just as it would be if the text were not a formula. See Punctuation after formulae at the mathematics MoS page.

Dates and time

For ranges of dates and times, see En dashes above.

Dates should only be linked when they are germane and topical to the subject, as discussed at Wikipedia:Manual of Style/Linking#Chronological items.

Time of day

Time of day is normally expressed in figures rather than being spelled out. Context determines whether the 12- or 24-hour clock is used.

Days

Choice of format

Months and seasons

Years and longer periods

More information on all of the above topics can be found at WP:MOSNUM#Dates, including the handling of dates expressed in different calendars, and times corresponding to different time zones.

Current

Use of the term "current" should be avoided. What is current today may not be tomorrow; situations change over time. Instead, use date- and time-specific text. To help keep information updated use the {{as of}} template.

Incorrect: He is the current ambassador to ...
Correct: As of 2011, he is the ambassador to ...

Numbers

MOSNUM clarifies a number of situations, including the following:

Currencies

Units of measurement

Common mathematical symbols

Grammar

Possessives

Shortcut:

For the apostrophe character, see #Apostrophes above. For thorough treatment of the English possessive see Apostrophe.

Singular nouns
Plural nouns
Official names
Pronouns

First-person pronouns

Shortcuts:

Wikipedia articles must not be based on one person's opinions or experiences, so never use I, my, or similar forms (except in quotations).

Also avoid we, us, and our: We should note that some critics have argued in favor of our proposal (personal rather than encyclopedic). But these forms are acceptable in certain figurative uses. For example:

Second-person pronouns

Shortcuts:

Do not use the second person (you, your); it is often ambiguous and contrary to the tone of an encyclopedia (see also Instructional and presumptuous language, below).

Plurals

Shortcuts:

Use the appropriate plural; allow for cases (such as excursus or hanif) in which a word is now listed in major English dictionaries, and normally takes an s or es plural, not its original plural: two excursuses, not two excursus as in Latin; two hanifs, not two hanufa as in Arabic.

Some collective nouns—such as team (and proper names of them), army, company, crowd, fleet, government, majority, mess, number, pack, and party—may refer either to a single entity or to the members that compose it. In British English, such words are sometimes treated as singular, but more often treated as plural, according to context. Exceptionally, names of towns and countries usually take singular verbs (unless they are being used to refer to a team or company by that name, or when discussing actions of that entity's government). For example, in England are playing Germany tonight, England refers to a football team; but in England is the most populous country of the United Kingdom, it refers to the country. In North American English, these words (and the United States, for historical reasons) are almost invariably treated as singular; the major exception is when sports teams are referred to by nicknames that are plural nouns, when plural verbs are commonly used to match. See also National varieties of English above.

Vocabulary

Contractions

Shortcuts:

Uncontracted forms such as do not or it is are the default in encyclopedic style; don't and it's are too informal. But contractions should not be expanded mechanically. Sometimes rewriting the sentence as a whole is preferable; and occasionally contractions provide the best solution anyway.

Gender-neutral language

Use gender-neutral language where this can be done with clarity and precision. This does not apply to direct quotations or the titles of works (The Ascent of Man), which should not be altered; or to wording about one-gender contexts, such as an all-female school (When any student breaks that rule, she loses privileges).

Ships may be referred to by either female pronouns ("she", "her") or genderless pronouns ("it", "its"). Either usage is acceptable, but each article should be internally consistent and employ one or the other exclusively. As with all optional styles, articles should not be changed from one style to another unless there is a substantial reason to do so. See Wikipedia:Manual of Style/Military history#Pronouns.

Contested vocabulary

Avoid words and phrases that give the impression of straining for formality, that are unnecessarily regional, or that are not widely accepted. See List of English words with disputed usage and List of commonly misused English words; see also Identity (below) and Gender-neutral language (above).

Instructional and presumptuous language

Shortcut:

Avoid such phrases as remember that and note that, which address readers directly in an unencyclopedic tone. Similarly, phrases such as of course, naturally, obviously, clearly, and actually make presumptions about readers' knowledge, and call into question the reason for including the information in the first place. Do not tell readers that something is ironic, surprising, unexpected, amusing, coincidental, etc. This supplies a point of view. Simply state the sourced facts and allow readers to draw their own conclusions.

Subset terms

A subset term identifies a set of members of a larger class. Common subset terms are including, among, and et cetera (etc.). Do not use redundant subset terms (so avoid constructions like these: Among the most well-known members of the fraternity are included two members of the Onassis family or The elements in stars include hydrogen, helium, etc.). Do not use including to introduce a complete list, where comprising, consisting of, or composed of would be more accurate.

Identity

Shortcut:

Foreign terms

Shortcut:

Foreign words should be used sparingly.

No common usage in English
Use italics for phrases in other languages and for isolated foreign words that are not current in English.
Common usage in English
Loanwords and borrowed phrases that have common usage in English—Gestapo, samurai, vice versa—do not require italics. A rule of thumb is not to italicize words that appear unitalicized in major English-language dictionaries.
Spelling and romanization

Names not originally written in a Latin alphabet (written for example in Greek, Cyrillic, or Chinese scripts) must be given a romanized form for use in English. Use a systematically transliterated or otherwise romanized name (Aleksandr Tymoczko, Wang Yanhong); but if there is a common English form of the name (Tchaikovsky, Chiang Kai-shek), use that form instead.

The use of diacritics (such as accent marks) for foreign words is neither encouraged nor discouraged; their usage depends on whether they appear in verifiable reliable sources in English and on the constraints imposed by specialized Wikipedia guidelines. Provide redirects from alternative forms that use or exclude diacritics.

Spell a name consistently in the title and the text of an article. See relevant policy at Article titles; see also Naming conventions (use English). For foreign names, phrases, and words generally, adopt the spellings most commonly used in English-language references for the article, unless those spellings are idiosyncratic or obsolete. If a foreign term does not appear in the article's references, adopt the spelling most commonly used in other verifiable reliable sources (for example other English-language dictionaries and encyclopedias). For punctuation of compounded forms, see relevant guidelines in Punctuation, above.

Sometimes the usage will be influenced by other guidelines such as National varieties of English, above, which may lead to different choices in different articles.

Technical language

Shortcuts:

Some topics are intrinsically technical, but editors should try to make them accessible to as many readers as possible. Minimize jargon, or at least explain it; or tag it using {{Cleanup-jargon}} or {{Jargon-statement}} for other editors to fix. For unavoidably technical articles a separate introductory article (like Introduction to special relativity) may be the best solution. Avoid excessive wikilinking (linking within Wikipedia) as a substitute for parenthetic explanations such as the one in this sentence. Do not introduce new and specialized words simply to teach them to the reader, when more common alternatives will do.

Geographical items

Places should generally be referred to consistently by the same name as in the title of their article (see Wikipedia:Naming conventions (geographic names)). Exceptions are made if there is a widely accepted historical English name appropriate to the given context. In cases where such a historical name is used, it should be followed by the modern name in round brackets (parentheses) on the first occurrence of the name in applicable sections of the article. This resembles linking; it should not be done to the detriment of style. On the other hand, it is probably better to provide such a variant too often than too rarely. If more than one historical name is applicable for a given context, the other names should be added after the modern English name, that is: "historical name (modern name, other historical names)".

Images

Shortcuts:

Avoid entering textual information as images

Textual information should almost always be entered as text rather than as an image. True text can be colored and adjusted with CSS tags and templates, but text in images cannot be. Images are not searchable, are slower to download, and are unlikely to be read as text by devices for the visually impaired. Any important textual information in an image should also appear in the image's alt text, caption, or other nearby text.

Captions

Shortcuts:

Photographs and other graphics should always have captions, unless they are "self-captioning" images (such as reproductions of album or book covers) or when they are unambiguous depictions of the subject of the article. In a biography article no caption is necessary for a portrait of the subject pictured alone; but one might be used, to give the year, the subject's age, or other circumstances of the portrait along with the name of the subject.

Formatting of captions

Bulleted and numbered lists

Links

Wikilinks

Make links only where they are relevant and helpful in the context: Excessive use of hyperlinks can be distracting, and may slow the reader down. Redundant links (like the one in the tallest people on Earth) clutter the page and make future maintenance harder. High-value links that are worth pursuing should stand out clearly.

Linking to sections: A hash sign (#) followed by the appropriate heading will lead to a relevant part of a page. For example, [[Apostrophe#Use in non-English names]] links to a particular section of the article Apostrophe.

Initial capitalization: Wikipedia's MediaWiki software does not require that wikilinks begin with an upper-case character. Only capitalize the first letter where this is naturally called for, or when specifically referring to the linked article by its name: Snakes are often venomous, but lizards only rarely (see Poison).

Check links: Ensure that the destination is the intended one; many dictionary words lead to disambiguation pages and not to complete or well-chosen articles.

External links

Do not use external links in the body of an article. Articles can include an external links section at the end, pointing to further information outside Wikipedia as distinct from citing sources. The standard format is a primary heading, ==External links==, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article. For example:

* [http://history.nih.gov/exhibits/history/index.html History of NIH]
* [http://nih.gov/ National Institutes of Health homepage]

These will appear as:

Add external links with discretion; Wikipedia is not a link repository.

Miscellaneous

Keep markup simple

The simplest markup is often the easiest to edit, the most comprehensible, and the most predictable. Markup may appear differently in different browsers. Use HTML and CSS markup sparingly; in particular, do not use the CSS float or line-height properties because they break rendering on some browsers when large fonts are used.

An HTML entity is sometimes better than the equivalent Unicode character, which may be difficult to identify in edit mode; for example, &Alpha; is understood where Α (the upper-case form of Greek α) may not be.

Formatting issues

Modifications in font size, blank space, and color (see Color coding, below) are an issue for the Wikipedia site-wide style sheet, and should be reserved for special cases only.

Typically, the use of custom font styles will:

Outside article text, different font sizes are routinely used in navigation templates and infoboxes, tables (especially in larger ones), and some other contexts where alternatives are not available (such as table captions). Specify font sizes relatively (for example in CSS with font-size: 80%) rather than absolutely (like font-size: 8pt).

Color coding

Shortcut:

Information should be accessible to all. Do not use color alone to mark differences in text: they may be invisible to people with color blindness. Also, black-and-white printouts, older computer displays with fewer colors, and monochrome displays (older PDAs and cell phones) cannot show such distinctions.

Choose colors that can be distinguished by the readers with the commonest form of colorblindness (red–green), such as maroon and teal; and also mark the differences with change of font or some other means (maroon and alternative font face, teal). Viewing the page with Vischeck can help with the choice of colors. See also color coding.

Scrolling lists and collapsible content

Shortcuts:

Scrolling lists, and boxes that toggle text display between hide and show, should not conceal article content, including reference lists, image galleries, and image captions. They especially should not be used to conceal "spoiler" information (see Wikipedia:Spoiler). Collapsible sections or cells may be used in tables that consolidate information covered in the main text, navboxes, infoboxes, or chess puzzles. When scrolling lists or collapsible content are used, take care that the content will still be accessible on devices that do not support JavaScript or CSS.

Invisible comments

Shortcut:

Editors use invisible comments to communicate with each other in the body of the text of an article. These comments are visible only in the wiki source (that is, in edit mode), not in read mode.

Invisible comments are useful for flagging an issue or leaving instructions about part of the text, where this is more convenient than raising the matter on the talk page. They should be used judiciously, because they can clutter the wiki source for other editors. Check that your invisible comment does not change the formatting, for example by introducing white space in read mode.

To leave an invisible comment, enclose the text you intend to be read only by editors between <!-- and -->. For example: <!--If you change this section title, please also change the links to it on the pages ...-->.

Pronunciation

Pronunciation in Wikipedia is indicated in the International Phonetic Alphabet (IPA). In most situations, for ease of understanding by the majority of readers and across variants of the language, quite broad IPA transcriptions are best for English pronunciations. See Wikipedia:IPA for English and Wikipedia:IPA (general) for keys, and {{IPA}} for templates that link to these keys. For English pronunciations, pronunciation respellings may be used in addition to the IPA.

See also

Notes

  1. ^ These matters have been addressed in rulings of the Arbitration Committee: see Wikipedia:Requests for arbitration/Jguk#Optional styles and Wikipedia:Requests for arbitration/Sortan#Preferred styles.
  2. ^ Wikipedia talk:Manual of Style/Archive 115#nbsp in a link
  3. ^ Specifically, compound attributives, which are modifiers of a noun that occur within the noun phrase. (See Hyphenated compound adjectives.)
  4. ^ This guidance follows the recommendations of various style guides, e.g. The Chicago Manual of Style, 16th ed. 2010, Clause 14.21, p. 666: "Relative to other punctuation, the [note] number follows any punctuation mark except for the dash, which it precedes. [...] Though a note number normally follows a closing parenthesis, it may on rare occasion be more appropriate to place the number inside the closing parenthesis—if, for example, the note applies to a specific term within the parenthesis." However note that some publications, such as the journal Nature, place references before punctuation.

Style guides on other Wikimedia projects

Further reading

Wikipedians are encouraged to familiarize themselves with other guides to style and usage, which may cover details that are not included in this Manual of Style. Among these are:

Search engines