Using Textile Markup

Textile is a lightweight markup language. it converts its marked-up text input to valid, well-formed XHTML and also inserts character entity references for apostrophes, opening and closing single and double quotation marks, ellipses and em dashes. When editing a course lesson, you’ll see a Formatting Guide in the sidebar indicating the syntax for some of the more commonly used elements. For a full Textile reference and editing sandbox, see the official documentation at


Headings range from h1 (big) to h6 (small). We recommend that you primarily use h1, h2, and h3 when writing your lessons, as anything smaller doesn’t really stand out from the body text.


Links can be created in a number of ways:

  1. The Textile markup for making a link looks like this: "link text":
  2. You can also use HTML, like so: <a href="">link text</a>. To make a link that opens in a new window or tab, use the ‘target’ parameter: <a href="" target="_blank">link text</a>.
  3. All URLs in the text will automatically be converted to links, so if you throw a in your text, it become a link.


  • Create bulleted lists (like this one) by placing an asterisk (*) before each item.
  • Create numbered ists by placing a hash/pound (#) before each item.
  • For both types of lists, each item must be on its own line, and you must insert a space after the * or #


If you’re familiary with HTML, you can create tables using standard HTML, or you can create them with Textile using the pipe character (Shift – \) as follows:

|_. a|_. table|_. header|


The following characters at the beginning of a line will determine the alignment of the line’s content.

> right
< left
= center
<> justify

Overriding Textile

If Textile is converting a piece of your text in an undesirable way, simply wrap that text in double-equals signs.

==*Not* gonna get _formatted_.==