Textile Reference Manual for RedCloth 4

Page Layout

Headings

Headings convey a hierarchy of information on the page. They structure the document like an outline. Heading 1 is the most important or general and Heading 6 is the least important or most specific. Leave a blank line after every heading.

Textile
h1. This is a Heading 1

This might be an introductory paragraph on the general topic.

h2. Heading 2 gets more specific

Now we're getting into the details.
Browser

This is a Heading 1

This might be an introductory paragraph on the general topic.

Heading 2 gets more specific

Now we’re getting into the details.

Block quotations

Block quotations designate long quotations where a paragraph break is appropriate. It ends with a blank line.

Textile
Even Mr. Sedaris, a noted luddite, has finally succumbed to doing his writing on a computer.  The Internet, however, remains an idiotic trifle:

bq. I've never seen the Internet. I don't have email. I just enjoy lying on the couch and reading a magazine. When people say, "You should visit my Web page," I'm always perplexed by it. Why? What do you do there?

Haven't we all pondered that at one time or another?
Browser

Even Mr. Sedaris, a noted luddite, has finally succumbed to doing his writing on a computer. The Internet, however, remains an idiotic trifle:

I’ve never seen the Internet. I don’t have email. I just enjoy lying on the couch and reading a magazine. When people say, “You should visit my Web page,” I’m always perplexed by it. Why? What do you do there?

Haven’t we all pondered that at one time or another?

Block quotations may include a citation URL immediately following the period.

Textile
A standard Lorem Ipsum passage has been used since the 1500s:

bq.:http://www.lipsum.com/ Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Browser

A standard Lorem Ipsum passage has been used since the 1500s:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

If your block quotation needs to go on for more than one paragraph, use two periods. The block quotation ends when a paragraph of a different type (such as an explicit paragraph or a header) is encountered.

Textile
bq.. This is one paragraph.

Another paragraph, also part of the quote.

p. A normal paragraph ends the quote.
Browser

This is one paragraph.

Another paragraph, also part of the quote.

A normal paragraph ends the quote.

Bullet lists

Make a bullet list with asterisks. Use more asterisks to make nested lists.

Textile
Textile has several advantages over HTML:

* It's easier on the eyes
* You don't have to write all those HTML tags
** By not writing the tags yourself, you're less likely to make coding mistakes
** It requires fewer keystrokes
*** You don't wear out the keys on your keyboard as fast
*** You won't wear out your fingers as fast
* You can write it much quicker
Browser

Textile has several advantages over HTML:

  • It’s easier on the eyes
  • You don’t have to write all those HTML tags
    • By not writing the tags yourself, you’re less likely to make coding mistakes
    • It requires fewer keystrokes
      • You don’t wear out the keys on your keyboard as fast
      • You won’t wear out your fingers as fast
  • You can write it much quicker

Numbered lists

Start each item in your numbered list with a number sign. For nested lists, use more number signs.

Textile
How to make a PB&J:

# Gather bread, peanut butter, and jelly
# Slice the bread if necessary
# Assemble the sandwich
## Spread peanut butter on one slice of bread
## Put jelly on another slice
## Put the two slices together
# Enjoy
Browser

How to make a PB&J:

  1. Gather bread, peanut butter, and jelly
  2. Slice the bread if necessary
  3. Assemble the sandwich
    1. Spread peanut butter on one slice of bread
    2. Put jelly on another slice
    3. Put the two slices together
  4. Enjoy

Mixed nested lists

You can nest ordered lists inside unordered lists and vice-versa.

Textile
Three reasons to walk to work:

# It saves fuel
# It's good for your health
** Walking burns calories
** Time outside means lower stress
# It's good for the environment
Browser

Three reasons to walk to work:

  1. It saves fuel
  2. It’s good for your health
    • Walking burns calories
    • Time outside means lower stress
  3. It’s good for the environment

Definition lists

Each term in a definition list starts with a dash. Put a := between the term and the definition. If your definition spans multiple lines, end the definition with =:

Textile
- coffee := Hot and black
- tea := Also hot, but a little less black
- milk :=
Nourishing beverage for baby cows.

Cold drink that goes great with cookies. =:
Browser
coffee
Hot and black
tea
Also hot, but a little less black
milk

Nourishing beverage for baby cows.

Cold drink that goes great with cookies.

Footnotes

To reference a footnote, place the footnote number in square brackets. Don’t forget the corresponding footnote at the bottom of the page.

Textile
42.7% of all statistics are made up on the spot.[1]

fn1. "Dr. Katz":http://en.wikiquote.org/wiki/Steven_Wright
Browser

42.7% of all statistics are made up on the spot.1

1 Dr. Katz

Tables

Simple tables are made by separating each cell with vertical pipes. Begin the cell with _. to indicate the cell is a heading.

Textile
|_. name|_. age|
|Walter|5|
|Florence|6|
Browser
name age
Walter 5
Florence 6

You can make a table cell span rows or columns with a slash or backslash and the number to span. Classes, IDs, style, and alignment are also possible on table cells as with other elements.

Textile
|{background:#ddd}. Cell with background|Normal|
|\2. Cell spanning 2 columns|
|/2. Cell spanning 2 rows|one|
|two|
|>. Right-aligned cell|<. Left-aligned cell|
Browser
Cell with background Normal
Cell spanning 2 columns
Cell spanning 2 rows one
two
Right-aligned cell Left-aligned cell

To apply attributes to the entire table, use the table. signature on a line by itself before the table data.

Textile
table(#prices).
|Adults|$5|
|Children|$2|
Browser
Adults $5
Children $2

Divisions

DIV tags are used to define a division or section in an HTML document. It has no inherent meaning, but is often used by designers and developers to group or style part of a page differently than another. You can easily create a div with Textile but most people who need a div just use HTML tags in their Textile.

Textile
div. A simple div.
Browser
A simple div.