Kongregate Forum Textile Formatting
This page serves as a reference for most of the formatting you'll be able to do in our forum posts. Kongregate Forums can accept two types of formatting: HTML and Textile. However, they do not offer full HTML/Textile functionality (believe me, you don't want marquee tags to work in the forums!). Also, thank you to the RedCloth Textile Reference, which was used as a reference for much of this guide (though again note that not all of the features listed at that site are supported by us).
This guide will not go over the HTML functionality since most of that is easily available online, though I'll point out that embedding things like .swf's and Youtube videos is no longer supported thanks to someone abusing the function in order to wreak havoc on some of our users. Most of the functionality described below can also be done with HTML if you prefer. Also, there is a character limit on posts past which we will no longer parse Textile (this was necessary for performance reasons), so if you're planning to write a really long post you may want to consider using HTML instead.
Textile's primary advantage is speed of notation. It doesn't offer too much power beyond HTML, and is sometimes a little fickle, but is often much quicker to type than HTML's tag format.
A first important thing to understand is that paragaphs are easily separated in Textile using a blank line. This helps with consistent formatting and is important occasionally with some of these tools.
This is a paragraph. This is a different one.
Probably the two most common Textile formats are bold and italics.
Bold can easily be accomplished by sandwiching the bold section in *'s. Note that you can't have spaces between the * and the text:
These words are *in bold*. To compare, HTML <b>bold</b> requires quite a few more keystrokes.
Italics are similarly marked using _'s:
Much easier to _italicize_ with two characters than to use <i>seven</i> for the same job!
Links are very quick and easy to type with Textile. You put the linked text in quotes, add a colon, and then the full URL (with http://) is appended. Voila, a link:
Check out "our awesome site":http://www.kongregate.com by clicking this link.
Embedding images is a snap as well - just put !'s on both sides of the image URL. Note that the URL must go directly to the image file.
Textile does allow for some slightly more obscure notation as well. For instance, if you're a math major, you may want to be able to write formulas, such as 4 = log101002. Easy enough:
4 = log ~10~ 100 ^2^
If you want to get rid of the spaces, you can make use of Textile's bracket notation and go with this instead:
4 = log[~10~]100[^2^]
You can mark
-remove this text- and +add this text+
In case you think something you wrote was just that important, you can add copyright notification using (c), (r), and (tm).
The block quote Textile command used to be more useful, but the recent "quote post" button made it somewhat obsolete. Still, if you wish to use it, it's fairly simple. Simply type bq. and then add the text that you want quoted after it. Note that this is a one-paragraph quotation. To do multiple paragraphs, use bq.., though you'll need to start your next non-quoted line with p. symbol.
bq. This is a single block quote paragraph. As long as there isn't a blank line it will keep quoting. But this new paragraph won't be quoted. bq.. However, if we use this notation, then the next paragraph will be quoted too. This will continue... p. until we identify a normal paragraph with this symbol.
If you need to use HTML-style headings, you can apply them to paragraphs using h1., h2., etc.:
h1. This is a level 1 heading.
Finally, we have support for numbered and bulleted lists in Textile. These can easily be created with the # (numbered) and * (bulleted) symbols. Just put one at the beginning of each line and a single space after each one, like so:
# This is # a numbered # list.
In case you're wondering how to write Textile code, or any other sort of code, without it all getting parsed, you can either use the HTML pre or code tags, or use Textile's version. To inline code, use the @ symbol:
You can explain how use Textile with examples @*in* _code_ ^symbols^@ very easily.
If you need to go larger, the bc. (block code) or bc.. can be used just like the block quote symbol. Similarly, you can use pre. and pre.. commands to use pre-formatted text.
Ok, so, you really want to show off your Textile 1337ness? There likely aren't many uses of this outside of the Serious Discussion forum, but occasionally you may want to be able to add footnotes to your post. Wherever you want the footnote, just put [#] at that point, where # is the footnote number. Then, at the bottom of your post, use fn#. to cite the footnote. For example:
Kongregate is a kick-ass website. fn1. "50 Kick-Ass Websites You Need to Know About":http://tiny.cc/mC2dP
Congratulations, you are now a Kongregate Forum Formatting ninja. Go forth and spread your vast wisdom of all topics to the community, and do so in the greatest of style!