troperville

tools

toys


main index

Narrative

Genre

Media

Topical Tropes

Other Categories

TV Tropes Org
random
Administrivia: Text Formatting Rules
aka: Text Formatting
This page provides a more complete list of some of the markup sequences available in TV Tropes wiki pages and forum posts. Note that it's easy to create and edit pages without using any of the markups below, but if you ever need them, they're here.

To experiment with the rules, please try editing the Wiki Sandbox. Some additional markup may be listed in a box when you are actually editing a page.

See also Images in Wiki Pages for more formatting tips, and Example Indentation in Trope Lists.


References

  • Join capitalized words (WikiWords) to make references to other pages on this Wiki. Custom titles and/or spaces between the words will be automatically applied.
  • Links with arbitrary text labels ("piped links") can be created in double brackets as [[url text]] or [[WikiWord text]]. Text can be an image URL, in which case the image becomes the link to the remote url or Wiki Word. In TVTropes parlance this is a Pot Hole.
  • Curly braces {{ }} will convert just about any word or phrase (excluding punctuation marks) into an article link by the same name. Note that this is the only way to link to articles with single-word titles (such as Plot), because there's no way to Wiki Word them.
    • Text added to the outside of the brackets can be included in the link. This is useful for pluralizing links; for example {{wiki word}}s links to the Wiki Word page but looks like wiki words.
    • If you want the inverse of that, use the | character: For example, Administrivia/{{Renamed Trope|s}} displays "Renamed Trope" while linking to Renamed Tropes.
    • Note that this markup does not automatically apply spacing or custom titles — the spacing and capitalization will be rendered exactly as-is. This can be useful for some articles with nonstandard spacing (e.g. {{MacGuffin}}), although we've got most of them covered by the custom-title system already.
    • Curly braces can be included in piped links, e.g. [[{{article}} phrase text]].
  • URLs can be placed in double brackets [[url]] when the URL itself is not important to the text. For example, [[http://www.google.com/]] will appear as [1].
  • Troper handles: They all go in the Tropers/ namespace. You can reference one by typing @/{{Tropername}} or @/TroperName.
  • To prevent a CamelCase word from being linked when you don't want it to, use the "Escape sequence" described below. For example: [=CamelCase=]

All internal references by default point to "Main." To link to a page in a different namespace, put it in front of the wiki word:
Test/{{Trope}} gives Trope.

If for some reason you want your link to show the namespace, you can use a period instead of a slash:
Test.{{Trope}} gives Test.Trope.


Paragraphs

  • Do not indent paragraphs.
  • Words wrap and fill as needed.
  • Use blank lines as separators.
  • Use \ (backslash) at the end of a line to join the next line to the current one.
  • Use \\ (two backslashes) at the end of a line to force a line break, or [ softreturn ] (sans the spaces) in the middle of a line for the same effect.
    This is an example.

Bulleted Lists

Bullet lists are made by placing asterisks at the left margin. More asterisks increases the level of bullet. We limit to three levels:

  • First-level list item
    • Second-level list item
      • A third level item
      • Four bullets, but still a third level item!
    • Another second-level item
  • A first-level item


Horizontal Line

Four or more dashes (----) at the beginning of a line produce a horizontal line.


Emphasis

  • Use doubled single-quotes (''), i.e., two apostrophes, for emphasis (usually italics)
  • Use tripled single-quotes ('''), i.e. three apostrophes, for strong emphasis (usually bold)
  • Use five single-quotes ('''''), or triples within doubles (five apostrophes), for some other kind of emphasis (usually bold italics)
  • Use pairs of doubled at-signs (@@monospace@@) for
    monospace
    text.
    • Note: the two pairs of at-signs have to be on the same line of markup text, and they cause line breaks.
    • The equivalent of < pre > is to put double at-signs at the beginning and end of each line.
  • Emphasis can be used multiple times within a line, but cannot span across markup line boundaries (i.e., you can't put a paragraph break in the middle of bold text).
  • Little note about potholes and emphasis: the single-quotes need to go outside the brackets in order for it to work properly. For example, ''[[PotHole this]]'' is the right way, and gets you this. On the other hand, [[PotHole ''this'']] is the wrong way, and leaves you with ''this''. In order to bold/italicize only part of a pothole, you need to make a separate one; ''[[PotHole like]]'' '''[[PotHole this]]''', for instance, to get it like this.


Text Effects

  • Big and Small caps: [[AC:Text]] for Text (as opposed to using [-...-] for ALL CAPS in smaller text)
  • Superscript: [[superscript:2]] for 2
  • Subscript: [[subscript:2]] for 2
  • Spoiler tagging: [[spoiler:hide this text]] for hide this text.
  • Strike-through: [[strike:text]] (note that, due to abuse, this only works on the forums, and is invisible on the wiki proper)
  • Reduce Text Size: [-text-]gives you text. More dashes mean smaller text, such as [--text--] gives you text.

Images

URLs ending with .gif, .jpg, or .png are displayed as images in the page and float left, allowing text to appear on the right if there is room.

Making an image caption: [[caption-width:number:some text]] will place an enclosed box under the image. Setting the number parameter to the width of the image will make the caption line up nicely with the image.

To shift an image and text to the right:

For images: [[quoteright:Number:Image URL]]

For text: [[caption-width-right:number:some text]]


Genre box

The genre box was a floatbox in work pages that can be used to show a work's Format and Genre. It worked with a ~~FIRSTNAME, SECONDNAME~~ markup, where the FIRSTNAME shows the format and SECONDNAME the genre. This markup is outdated; please remove it wherever you see it.


Redirects

If you want a trope title to redirect to another trope with content (e.g. make Buffy point to Buffy the Vampire Slayer), in Buffy enter the following (but see Creating New Redirects first for guidelines!):

[[redirect:BuffyTheVampireSlayer]]

Note that redirects to single word titles (such as Handguns) must have the page title be surrounded by double curly brackets. Like so: {{Handguns}}

See Creating New Redirects for more information.


Headings

Headings are made by placing a exclamation mark (!) at the left margin. More exclamation marks increases the level of heading. For example,

Level 1 Heading

Level 2 Heading

Level 3 Heading

There are also thinner headings, chiefly used on Wild Mass Guessing pages. These can be made with [[WMG:text]] or [[header:text]], thus...
The header header is as thick as a level 1 header but not emboldened.

Escape Sequence

Anything placed between [= and =] is not interpreted. This makes it possible to easily do WikiWords that are not links and turn off other special formatting interpretation. The [= and =] can span multiple input lines, allowing effects to be applied to multiple input lines.

This is useful when combined with monospace markup: for a computer program listing, surround lines with @@[= and =]@@ to be monospace and uninterpreted.

Note that some markups—if left complete within the escape sequence—are interpreted. The redirect markup is one. For these, you will need to escape in parts, like just the brackets.

Numbered Lists

Numbered lists are made by placing number-signs (#) at the left margin.

  1. Prepare the experiment
    1. Unwrap the pop-tart
    2. Insert the pop-tart into the toaster
  2. Begin cooking the pop tart
  3. Stand back

The starting number can be changed by putting [numlist:START_NUMBER] at the beginning of the list and [/numlist] at the end, where START_NUMBER is the number you want the list to start at. Inside this block, all lines that do not begin with "#" are treated as comments and are not displayed; nested lists are not supported here, either.

  1. Prepare the experiment
  2. Unwrap the pop-tart
  3. Insert the pop-tart into the toaster
  4. Begin cooking the pop tart
  5. Stand back
  6. If cooking bacon at the same time, make sure to not back towards the stove unless you're wearing a shirt. And pants.


Definition Lists

Definition lists are made by placing colons at the left margin:

:term:definition of term
::second-level item: definition of 2nd-level item

becomes

term
definition of term
second-level item
definition of 2nd-level item

This effect can be duplicated by using "->", where each additional "-" increases the indent. Font size is decreased for lines prefixed in this manner. Note: insert a dummy comment line before each indented line (-- and higher) to ensure that all indents show.
->term
%%NO COMMENTO
-->definition of term
%%NO COMMENTO
-->second-level item
%%NO COMMENTO
--->definition of 2nd-level item
%%No comment?
becomes
term
definition of term
second-level item
definition of 2nd-level item


Quotes Formatting

In order to keep the wiki looking crisp and clean, we prefer standardized formatting for quotes across the entire site. The formatting can be a little bit complicated at first glance.

General Formatting

Always bold the names of the people speaking in the quote, with a colon after their name. Do not italicize the text of the quote itself, except parts of it for emphasis. Don't use anything else to indicate emphasis (except all caps and bolding, used sparingly); don't use apostrophes, underscores, slashes, [i][/i], or anything of that nature. Don't enclose the dialogue in inverted commas or quotation marks. Stage directions and actions go in square brackets, italicized. For example:

->'''David:''' ''[deadpan]'' Maybe we should actually get some ''work'' done?

Becomes:

David: [deadpan] Maybe we should actually get some work done?

Page Quotes

Page quotes (or quotes on a quotes page) work slightly differently from other quotes. First, use one dash for the indent, -> (see Quotes Indentation, below). If it's only one person speaking, then italicize the line with double quotes ('') and put it in quotes, and put their name in bold on the line below. On a related note, do not put potholes in a quote at the top of a page (see What to Put at the Top of a Page). For example:

->''"Not everyone can win."''
-->-- '''Alice''', ''Wiki/TVTropes''

Becomes:

"Not everyone can win."
Alice, TV Tropes

Note that the second line is given an additional dash to indent it further, two dashes are added after the arrow to create a line, and Alice's name is bolded.

If it's more than one person speaking, then it becomes the same as the other quotes. Bold the names of the speakers with triple quotes ('''), and do not italicize the line or put it in quotes. For the last line, still indent it with two dashes, but don't put the character's names. For example:

->'''Alice:''' Not everyone can win.\\
'''Bob:''' Not all the time.
-->-- ''Wiki/TVTropes''

Becomes:

Alice: Not everyone can win.
Bob: Not all the time.

Note the use of backslashes. These are a Text Formatting trick that tells the system to indent the line below at the same level. They are required for any multi-line quotes.

Article Quotes:

Unlike page quotes, quotes in the body of the article itself do not need the context of having the name of the work in the line below; that is provided by the example it is listed under. Therefore, all quotes under examples, whether single-line or multiple, use the "multiple line quote" (so to speak) formatting. For example:

* In ''Wiki/TvTropes'', Alice drops a foreboding line at one point.
-->'''Alice:''' Not everyone can win.

which produces:

  • In TV Tropes, Alice drops a foreboding line at one point.
    Alice: Not everyone can win.

You'll also notice that the quote was indented farther than the page quote was. That was because two dashes were used (-->), because otherwise it would look bad under the bullet indent. Always use one dash for your quotes, plus one dash for every bullet. So page quotes get one dash (->), one bullet gets two dashes (-->), two bullets get three (--->), and three bullets get four dashes (---->). Note, however, that an example very rarely needs three bullets—see Example Indentation in Trope Lists for more on that.

If you need to continue a bullet point after a quote, you can use double colons (see above — three colons for second-level bullet points and four for third-level) to match the indentation level.

Literature Quotes:

Books are frustrating to quote at times. There are two ways to do it. If it's a straight quote, exactly what the character said, then just follow the rules above. For example:

->'''Charlie:''' That doesn't mean everyone always loses.

can be used to make

Charlie: That doesn't mean everyone always loses.

However, if you are lifting an entire passage of the book, then simply copy it directly, without adding the character's name in bold, italicizing the text, or adding any additional quotes. For example:

->Charlie scrunched up his face at his friends' fatalism. "That doesn't mean everyone always loses," he noted.

making

Charlie scrunched up his face at his friends' fatalism. "That doesn't mean everyone always loses," he noted.


Tables

Table are defined by enclosing cells with '||'. A cell with leading and trailing spaces is centered; a cell with leading spaces is right-aligned; all other cells are left-aligned. An empty cell will cause the previous cell to span multiple columns. (There is currently no mechanism for spanning multiple rows.) A line beginning with '||' specifies the table attributes for subsequent tables.

||align=center border=1 width=50%
||Left || Center || Right||
||A || B || C||
|| || single || ||
|| || multi span ||||
Left Center Right
A B C
  single  
  multi span


Footnotes

A footnote lets you hide some text behind a JavaScript link. The reader has to click the link to expand the text in-place. Somewhat similar to the spoiler tag, but for non-spoiler information, and unlike spoiler text, it takes up almost no room until expanded. Very useful for collapsing a tenuously related or humourous aside, or additional explanatory text that would otherwise be cluttering up the trope description.

This is an example of a footnote. [[note]]tenuously related or humourous aside[[/note]] 

This is an example of a footnote. note 

You can use anything you want as the thing to click so long as it doesn't contain a Wiki Word or other markup, although an asterisk (star, splat, *) is common:

[[labelnote:Don't click me!]]Click the example below to see the real text.[[/labelnote]] 

Don't click me! 

The [[labelnote]] tag obsoletes the previous [[hottip]] tag, which used a less robust syntax that gave the parser fits when someone tried to include a pothole in a hottip. ([[hottip:somelabel:long description]] was roughly equivalent to [[labelnote:somelabel]]long description[[/labelnote]].) A cleanup effort is ongoing to convert old hottips. Unfortunately, the JavaScript that makes [[note]] and [[labelnote]] work does not work in preview, so use the Wiki Sandbox for testing the markup if you're doing something inventive.


Folders

Long spans of text can be collapsed like so:

[[folder:Title Or Description]]
Text to hide.
* List
* To
* Hide
[[/folder]]

    Title Or Description 
Text to hide.
  • List
  • To
  • Hide

Pages with collapsing folders often have a folder control listed first:

[[foldercontrol]]

    open/close all folders 


Quote Blocks

Useful only on the forums, since the markup doesn't work in the main wiki. It can be practiced in the Sandbox forum.

[[quoteblock]] Text that you want to quote [[/quoteblock]].


Special Characters

HTML special characters can be used ("named character entities"). There is a list of them here, and a longer list here.

Right To Left Text

Some languages and scripts like Arabic or Hebrew require the opposite of the usual left to right text flow.

For example [[rtl:Text goes here.]] would end up as this:

Text goes here.

Notice that the punctuation will be mirrored accordingly.

Comments

Text following a %% tag, up to the end of the line, is not displayed and will be visible only in the editing markup. Using this tag at the start of the line will make the entire line hidden from view. It doesn't work in headers.

Any word surrounded by percent signs — e.g. %comment%, %rem%, or so on, will also be treated as a comment marker and text following it (until the end of line) will not be displayed.

Note that any line containing an external link will not allow a comment after the link. This is to prevent parts of the URL from becoming part of a comment in case the URL has more than one percent sign in it. This line, for example, won't, due to the following link to this page. [2] %This% shows up normally on the line. URLs can be placed within a comment without the comment showing up on the page, however.

Examples:

Behold as I disappear as if by %Author% Existence Failure!
Behold as I disappear as if by

%%Behold as I disappear as if by Author Existence Failure!

Alternatively, an entire comment block can be created by utilizing a side-effect of the "numlist" block discussed above, where no lines that do not start with # are displayed.

Notifying people of forum posts they might be interested in.

You can notify tropers about a forum post they might be interested in by putting ~Tropers/NameOfTheTroper or ~Tropers/{{Handle}} in your forum post. Upon hitting "Send", this automatically sends the troper in question a private message, calling their attention to the forum post.

This only works in the forums, and only in the add post function; you can't send a message that way by editing the markup into an already existing forum post.

Special markup

There are a few special markups on the wiki:
  • [[noreallife]]: Designed for pages that are No Real Life Examples, Please!, it replaces the edit tips with a big red note saying not to add Real Life examples.
  • [[invoked]]: When YMMV or Trivia items are placed on work pages, they will display a red weighing scale/gray interrobang and a notice on the edit screen asking for them to be moved. Since In-Universe or Played With examples aren't really YMMV, this markup can be added to the examples to prevent the notice and modified bullets from showing up.
  • [[#AnchorPoint]]: Creates a point on a wiki page for linking to, in the same way that headings on Wikipedia can be linked individually. For something with a lot of sections, put one of these in each heading with the same text as the heading itself for ease of navigation. Link by typing Namespace/PageTitle#AnchorPoint.
  • [[hardline]]: This acts like the ---- line, except it's invisible on the page. It's useful when messing with text around images.
  • [[AATAFOVS:Sandworm]] or [[AATAFOVS:Sand Worm]] give a box about Avatar and the Airbending Fellowship of Vampire Slayers, indicating Sandworm as the recapper of the episode in question.

How to Write an ExampleAdministriviaTips for Editing
Naming a TropePt/Índice de TraduçãoAction Girl

alternative title(s): Wiki Markup; Text Formatting; Markup Help; Text Formatting Rules; Wiki Markup Help; Text Formatting; Quotes Formatting
random
TV Tropes by TV Tropes Foundation, LLC is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.
Permissions beyond the scope of this license may be available from thestaff@tvtropes.org.
Privacy Policy
32590
32