### Install RedCloth Gem

Source: https://github.com/jgarber/redcloth/blob/master/README.rdoc

Install the RedCloth gem using RubyGems. This is the standard method for adding the library to your Ruby environment.

```bash
gem install RedCloth
```

--------------------------------

### Numeric Lists: Basic

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Creates an ordered (numbered) list. Each list item starts with '#'.

```textile
# A first item
# A second item
# A third
```

```html
<ol>
<li>A first item</li>
<li>A second item</li>
<li>A third</li>
</ol>
```

--------------------------------

### Bulleted Lists: Basic

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Creates an unordered (bulleted) list. Each list item starts with '*'.

```textile
* A first item
* A second item
* A third
```

```html
<ul>
<li>A first item</li>
<li>A second item</li>
<li>A third</li>
</ul>
```

--------------------------------

### Creating Simple Tables with Textile

Source: https://github.com/jgarber/redcloth/blob/master/README.rdoc

Demonstrates the syntax for creating simple tables in Textile. Columns are separated by pipes, and rows are on separate lines. Styles can be applied using curly braces.

```textile
|a|simple|table|row|
|And|Another|table|row|
```

--------------------------------

### Basic RedCloth Usage

Source: https://github.com/jgarber/redcloth/blob/master/README.rdoc

Demonstrates the basic usage of RedCloth by initializing it with a Textile string and converting it to HTML. Ensure you `require 'redcloth'` first.

```ruby
require 'redcloth'

text = "This is *my* text."
RedCloth.new(text).to_html
```

--------------------------------

### Basic Paragraphs and Line Breaks

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Demonstrates how Textile handles paragraphs separated by blank lines and how single line breaks are converted to HTML breaks.

```Textile
A single paragraph.
  
Followed by another.
```

```HTML
<p>A single paragraph.</p>  
  
<p>Followed by another.</p>
```

--------------------------------

### Multi-line Textile to HTML Conversion

Source: https://github.com/jgarber/redcloth/blob/master/README.rdoc

Shows how to process multi-line Textile content using a heredoc with RedCloth. The output is then printed to the console.

```ruby
require 'redcloth'

doc = RedCloth.new <<EOD
h2. Test document

 Just a simple test.
EOD
puts doc.to_html
```

--------------------------------

### Hypertext Links: Basic

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Creates a basic hyperlink. The text in quotes is the link text, followed by the URL.

```textile
"Google":http://google.com
```

```html
<p>I searched <a href="http://google.com">Google</a>.</p>
```

--------------------------------

### Block Alignment: Justified

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Justifies block content. Use 'p<>.' for justified alignment.

```textile
p<>. justified
```

```html
<p style="text-align:justify;">justified</p>
```

--------------------------------

### Filtering HTML with RedCloth

Source: https://github.com/jgarber/redcloth/blob/master/README.rdoc

Illustrates how to filter potentially unsafe HTML tags, such as script tags, when converting Textile to HTML using RedCloth. This is done by passing an options array to the RedCloth constructor.

```ruby
RedCloth.new("<script>alert(1)</script>", [:filter_html]).to_html
```

--------------------------------

### Block Alignment: Center

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Centers block content. Use 'p=.' for center alignment.

```textile
p=. centered
```

```html
<p style="text-align:center;">centered</p>
```

--------------------------------

### Combined Alignment and Indentation

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Combines indentation and alignment. 'h2()>' applies left/right padding and right alignment.

```textile
h2()>. Bingo.
```

```html
<h2 style="padding-left:1em; padding-right:1em; text-align:right;">Bingo.</h2>
```

--------------------------------

### Combined Alignment, Indentation, and Language/Style

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Combines alignment, indentation, language attribute, and CSS styles. 'h3()>["no"]{color:red}.' applies these attributes.

```textile
h3()>["no"]{color:red}. Bingo
```

```html
<h3 style="color:red; padding-left:1em; padding-right:1em; text-align:right;" lang="no">Bingo</h3>
```

--------------------------------

### Styling Tables in Textile

Source: https://github.com/jgarber/redcloth/blob/master/README.rdoc

Shows how to apply CSS styles to tables and cells in Textile. Styles are defined within curly braces preceding the table or row definition.

```textile
table{border:1px solid black}.
{background:#ddd;color:red}. |a|red|row|
```

--------------------------------

### Indentation: Left 1em

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Indents block content 1em to the left. Use 'p(.' for left indentation.

```textile
p(. left ident 1em
```

```html
<p style="padding-left:1em;">left ident 1em</p>
```

--------------------------------

### Line Breaks

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Illustrates how Textile converts explicit line breaks into HTML break tags.

```Textile
I spoke.  
And none replied.
```

```HTML
<p>I spoke.  
And none replied.</p>
```

--------------------------------

### En-Dash

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Illustrates the conversion of single hyphens into en-dashes.

```Textile
Observe - tiny and brief.
```

```HTML
<p>Observe &#8211; tiny and brief.</p>
```

--------------------------------

### Block Alignment: Right

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Aligns block content to the right. Use 'p>.' for right alignment.

```textile
p>. align right
```

```html
<p style="text-align:right;">right align</p>
```

--------------------------------

### Indentation: Left 2em

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Indents block content 2em to the left. Use 'p((.' for 2em left indentation.

```textile
p((. left ident 2em
```

```html
<p style="padding-left:2em;">left ident 2em</p>
```

--------------------------------

### Curly Quotes

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Demonstrates the conversion of single and double quotes to typographic curly quotes.

```Textile
"Observe!"
```

```HTML
<p>&#8220; Observe!&#8221;</p>
```

--------------------------------

### Block Alignment: Left

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Aligns block content to the left. Use 'p<.' for left alignment.

```textile
p<. align left
```

```html
<p style="text-align:left;">align left</p>
```

--------------------------------

### Header 1

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Defines a block of text as a level 1 HTML header using 'h1.' prefix.

```Textile
h1. Header 1
```

```HTML
<h1>Header 1</h1>
```

--------------------------------

### Header 2

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Defines a block of text as a level 2 HTML header using 'h2.' prefix.

```Textile
h2. Header 2
```

```HTML
<h2>Header 2</h2>
```

--------------------------------

### Indentation: Right 3em

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Indents block content 3em to the right. Use 'p))).' for 3em right indentation.

```textile
p))). right ident 3em
```

```html
<p style="padding-right:3em;">right ident 3em</p>
```

--------------------------------

### Apply Table-Wide Attributes

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Apply attributes to an entire table by placing them on a separate line before the first row, followed by a period. This sets table-level styling.

```textile
table{border:1px solid black}.
|This|is|a|row|
|This|is|a|row|
```

--------------------------------

### Numeric Lists: Nested

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Creates nested ordered lists. Increase the number of '#' symbols for deeper nesting levels.

```textile
# Fuel could be:
## Coal
## Gasoline
## Electricity
# Humans need only:
## Water
## Protein
```

```html
<ol>
<li>Fuel could be:
<ol>
<li>Coal</li>
<li>Gasoline</li>
<li>Electricity</li>
</ol>
</li>
<li>Humans need only:
<ol>
<li>Water</li>
<li>Protein</li>
</ol></li>
</ol>
```

--------------------------------

### Ellipsis

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Demonstrates how triplets of periods are converted into an ellipsis character.

```Textile
Observe...
```

```HTML
<p>Observe&#8230;</p>
```

--------------------------------

### Symbol Conversion

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Illustrates the conversion of trademark, registered, and copyright symbols.

```Textile
one(TM), two(R), three(C).
```

```HTML
<p>one&#8482;, two&#174;, three&#169;.</p>
```

--------------------------------

### Em-Dash

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Shows how double hyphens are converted into em-dashes.

```Textile
Observe -- very nice!
```

```HTML
<p>Observe&#8212; very nice!</p>
```

--------------------------------

### Header 3

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Defines a block of text as a level 3 HTML header using 'h3.' prefix.

```Textile
h3. Header 3
```

```HTML
<h3>Header 3</h3>
```

--------------------------------

### Embedding HTML: Pre and Code Tags

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Embeds preformatted code within 'pre' and 'code' tags. Textile processors ignore indented code within these tags.

```textile
<pre>
<code>
  a.gsub!( /</, '' )
</code>
</pre>
```

```html
<pre>
<code>
a.gsub!( /&lt;/,
'' )
</code>
</pre>
```

--------------------------------

### HTML within Textile

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Shows how HTML tags are handled within Textile, noting that they are escaped only within 'pre' or 'code' blocks.

```Textile
I am <b>very</b> serious.  
  
<pre>  
  I am <b>very</b> serious.  
</pre>
```

```HTML
<p>I am <b>very</b> serious.</p>  
  
<pre>  
I am &lt; b&gt; very&lt;/b&gt; serious.  
</pre>
```

--------------------------------

### Dimension Sign

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Shows how the letter 'x' used alone is converted into a dimension sign.

```Textile
Observe: 2 x 2.
```

```HTML
<p>Observe: 2&#215; 2.</p>
```

--------------------------------

### Bulleted Lists: Nested

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Creates nested unordered lists. Increase the number of '*' symbols for deeper nesting levels.

```textile
* Fuel could be:
** Coal
** Gasoline
** Electricity
* Humans need only:
** Water
** Protein
```

```html
<ul>
<li>Fuel could be:
<ul>
<li>Coal</li>
<li>Gasoline</li>
<li>Electricity</li>
</ul>
</li>
<li>Humans need only:
<ul>
<li>Water</li>
<li>Protein</li>
</ul></li>
</ul>
```

--------------------------------

### Embedding HTML: Div Tag for Sidebar

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Uses a 'div' tag with 'float:right' style to create a sidebar. This separates main content from sidebar content.

```textile
<div style="float:right;">

h3. Sidebar

"GitHub":http://github.com/
"Ruby":http://ruby-lang.org/

</div>

The main text of the
page goes here and will
stay to the left of the
sidebar.
```

```html
<div style="float:right;">
<h3>Sidebar</h3>

<p><a href="http://hobix.com/">GitHub</a>
<a href="http://ruby-lang.org/">Ruby</a></p>


</div>
<p>The main text of the
page goes here and will
stay to the left of the
sidebar.</p>
```

--------------------------------

### Apply Row-Specific Attributes

Source: https://github.com/jgarber/redcloth/blob/master/doc/textile_reference.html

Apply attributes to a single row by preceding it with the attribute definition, using the 'table' modifier, and a period. This allows for targeted row styling.

```textile
|This|is|a|row|
{background:#ddd}. |This|is|grey|row|
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.