RedCloth 3.0.4 → 4.0.0

data/lib/redcloth/textile_doc.rb

@@ -0,0 +1,105 @@
+module RedCloth
+  class TextileDoc < String
+    #
+    # Accessors for setting security restrictions.
+    #
+    # This is a nice thing if you're using RedCloth for
+    # formatting in public places (e.g. Wikis) where you
+    # don't want users to abuse HTML for bad things.
+    #
+    # If +:filter_html+ is set, HTML which wasn't
+    # created by the Textile processor will be escaped.
+    # Alternatively, if +:sanitize_html+ is set, 
+    # HTML can pass through the Textile processor but
+    # unauthorized tags and attributes will be removed.
+    #
+    # If +:filter_styles+ is set, it will also disable
+    # the style markup specifier. ('{color: red}')
+    #
+    # If +:filter_classes+ is set, it will also disable
+    # class attributes. ('!(classname)image!')
+    #
+    # If +:filter_ids+ is set, it will also disable
+    # id attributes. ('!(classname#id)image!')
+    #
+    attr_accessor :filter_html, :sanitize_html, :filter_styles, :filter_classes, :filter_ids
+
+    #
+    # Deprecated accessor for toggling hard breaks.
+    #
+    # Traditional RedCloth converted single newlines
+    # to HTML break tags, but later versions required
+    # +:hard_breaks+ be set to enable this behavior.
+    # +:hard_breaks+ is once again the default. The
+    # accessor is deprecated and will be removed in a
+    # future version.
+    #
+    attr_accessor :hard_breaks
+
+    # Accessor for toggling lite mode.
+    #
+    # In lite mode, block-level rules are ignored.  This means
+    # that tables, paragraphs, lists, and such aren't available.
+    # Only the inline markup for bold, italics, entities and so on.
+    #
+    #   r = RedCloth.new( "And then? She *fell*!", [:lite_mode] )
+    #   r.to_html
+    #   #=> "And then? She <strong>fell</strong>!"
+    #
+    attr_accessor :lite_mode
+
+    #
+    # Accessor for toggling span caps.
+    #
+    # Textile places `span' tags around capitalized
+    # words by default, but this wreaks havoc on Wikis.
+    # If +:no_span_caps+ is set, this will be
+    # suppressed.
+    #
+    attr_accessor :no_span_caps
+
+    # Returns a new RedCloth object, based on _string_, observing 
+    # any _restrictions_ specified.
+    #
+    #   r = RedCloth.new( "h1. A *bold* man" )
+    #     #=> "h1. A *bold* man"
+    #   r.to_html
+    #     #=>"<h1>A <b>bold</b> man</h1>"
+    #
+    def initialize( string, restrictions = [] )
+      restrictions.each { |r| method("#{r}=").call( true ) }
+      super( string )
+    end
+
+    #
+    # Generates HTML from the Textile contents.
+    #
+    #   RedCloth.new( "And then? She *fell*!" ).to_html
+    #     #=>"<p>And then? She <strong>fell</strong>!</p>"
+    #
+    def to_html( *rules )
+      apply_rules(rules)
+  
+      to(RedCloth::Formatters::HTML)
+    end
+
+    #
+    # Generates LaTeX from the Textile contents.
+    #
+    #   RedCloth.new( "And then? She *fell*!" ).to_latex
+    #     #=> "And then? She \\textbf{fell}!\n\n"
+    #
+    def to_latex( *rules )
+      apply_rules(rules)
+  
+      to(RedCloth::Formatters::LATEX)
+    end
+
+    private
+    def apply_rules(rules)
+      rules.each do |r|
+        method(r).call(self) if self.respond_to?(r)
+      end
+    end
+  end
+end

data/lib/redcloth/version.rb

@@ -0,0 +1,18 @@
+module RedCloth
+  module VERSION
+    MAJOR = 4
+    MINOR = 0
+    TINY  = 0
+    RELEASE_CANDIDATE = nil
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+    TAG = "REL_#{[MAJOR, MINOR, TINY, RELEASE_CANDIDATE].compact.join('_')}".upcase.gsub(/\.|-/, '_')
+    FULL_VERSION = "#{[MAJOR, MINOR, TINY, RELEASE_CANDIDATE].compact.join('.')}"
+  end
+  
+  NAME = "RedCloth"
+  GEM_NAME = NAME
+  URL  = "http://redcloth.org/"
+
+  DESCRIPTION = "#{NAME}-#{VERSION::FULL_VERSION} - Textile parser for Ruby.\n#{URL}"
+end

data/test/basic.yml

@@ -0,0 +1,794 @@
+--- 
+name: paragraphs
+desc: Textile looks for paragraphs in your text.  Paragraphs are separated by one blank line. Every paragraph is translated as an HTML paragraph.
+in: |-
+  A single paragraph.
+  
+  Followed by another.
+html: |-
+  <p>A single paragraph.</p>
+  <p>Followed by another.</p>
+---
+name: block containing block start
+in: |-
+  I saw a ship. It ate my elephant.
+html: |-
+  <p>I saw a ship. It ate my elephant.</p>
+---
+name: extended block containing block start
+in: |-
+  p.. I saw a ship. It ate my elephant.
+  
+  When the elephant comes to take a p. you...
+html: |-
+  <p>I saw a ship. It ate my elephant.</p>
+  <p>When the elephant comes to take a p. you&#8230;</p>
+---
+name: blockquote containing block start
+in: |-
+  bq. I saw a ship. It ate my elephant.
+html: |-
+  <blockquote>
+  <p>I saw a ship. It ate my elephant.</p>
+  </blockquote>
+---
+name: extended blockquote containing block start
+in: |-
+  bq.. I saw a ship. It ate my elephant.
+
+  When the elephant comes to take a p. you...
+html: |-
+  <blockquote>
+  <p>I saw a ship. It ate my elephant.</p>
+  <p>When the elephant comes to take a p. you&#8230;</p>
+  </blockquote>
+--- 
+name: notextile block containing block start
+in: |-
+  notextile. I saw a ship. It ate my elephant.
+html: |-
+  I saw a ship. It ate my elephant.
+valid_html: false
+---
+name: extended notextile block containing block start
+in: |-
+  notextile.. I saw a ship. It ate my elephant.
+
+  When the elephant comes to take a p. you...
+html: |-
+  I saw a ship. It ate my elephant.
+  
+  When the elephant comes to take a p. you...
+valid_html: false
+--- 
+name: pre block containing block start
+in: |-
+  pre. I saw a ship. It ate my elephant.
+html: |-
+  <pre>I saw a ship. It ate my elephant.</pre>
+---
+name: extended pre block containing block start
+in: |-
+  pre.. I saw a ship. It ate my elephant.
+
+  When the elephant comes to take a p. you...
+html: |-
+  <pre>I saw a ship. It ate my elephant.</pre>
+
+  <pre>When the elephant comes to take a p. you&#8230;</pre>
+  --- 
+name: html tags
+desc: You can certainly use HTML tags inside your Textile documents.  HTML will only be escaped if it&#8217;s found in a <code>pre</code> or <code>code</code> block.
+in: |-
+  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>
+--- 
+name: line breaks
+desc: Line breaks are converted to HTML breaks.
+in: |-
+  I spoke.
+  And none replied.
+html: |-
+  <p>I spoke.<br />
+  And none replied.</p>
+html_no_breaks: |-
+  <p>I spoke.
+  And none replied.</p>
+lite_mode_html: |-
+  I spoke.<br />
+  And none replied.
+--- 
+name: curly quotes
+desc: Single- and double-quotes around words or phrases are converted to curly quotations, much easier on the eye.
+in: "\"Observe!\""
+html: <p>&#8220;Observe!&#8221;</p>
+--- 
+name: double hyphens
+desc: Double hyphens are replaced with an em-dash.
+in: Observe--very nice!
+html: <p>Observe&#8212;very nice!</p>
+latex: "Observe---very nice!\n\n"
+--- 
+name: double hyphens with spaces
+desc: Double hyphens are replaced with an em-dash and surrounding spaces are preserved.
+in: Observe -- very nice!
+html: <p>Observe &#8212; very nice!</p>
+latex: "Observe --- very nice!\n\n"
+--- 
+name: single hyphens with spaces
+desc: Single hyphens are replaced with en-dashes if they are surrounded by spaces.
+in: Observe - tiny and brief.
+html: <p>Observe &#8211; tiny and brief.</p>
+latex: "Observe--tiny and brief.\n\n"
+--- 
+name: midword hyphens 
+desc: Single hyphens are left alone if not surrounded by spaces.
+in: Observe the nicely-done hyphen.
+html: <p>Observe the nicely-done hyphen.</p>
+--- 
+name: ellipses
+desc: Triplets of periods become an ellipsis.
+in: Observe...
+html: <p>Observe&#8230;</p>
+lite_mode_html: Observe&#8230;
+--- 
+name: dimension sign
+desc: The letter 'x' becomes a dimension sign when used between digits.
+in: "Observe: 2x3."
+html: "<p>Observe: 2&#215;3.</p>"
+--- 
+name: dimension sign with spaces
+in: "Observe: 2 x 4."
+html: "<p>Observe: 2 &#215; 4.</p>"
+--- 
+name: dimension signs chained
+in: "Observe: 2x3x4."
+html: "<p>Observe: 2&#215;3&#215;4.</p>"
+lite_mode_html: "Observe: 2&#215;3&#215;4."
+--- 
+name: dimension sign with double quotes
+in: 'My mouse: 2.5" x 4".'
+html: '<p>My mouse: 2.5&quot; &#215; 4&quot;.</p>'
+--- 
+name: dimension sign with single quotes
+in: "My office: 5' x 4.5'."
+html: "<p>My office: 5&#8217; &#215; 4.5&#8217;.</p>"
+--- 
+name: trademark and copyright
+desc: Conversion of trademark and copyright symbols.
+in: one(TM), two(R), three(C).
+html: <p>one&#8482;, two&#174;, three&#169;.</p>
+lite_mode_html: one&#8482;, two&#174;, three&#169;.
+--- 
+name: headers
+desc: To make an entire paragraph into a Header, place “h<em>n</em>.” at its beginning, where <em>n</em> is a number from 1-6.
+in: h3. Header 3
+html: <h3>Header 3</h3>
+--- 
+name: blockquote
+desc: To make an entire paragraph into a block quotation, place “bq.” before it.
+in: |-
+  Any old text
+  
+  bq. A block quotation.
+  
+  Any old text
+html: |-
+  <p>Any old text</p>
+  <blockquote>
+  <p>A block quotation.</p>
+  </blockquote>
+  <p>Any old text</p>
+--- 
+name: footnote reference
+desc: Numeric references within text to footnotes appear between square brackets.
+in: This is covered elsewhere[1].
+html: <p>This is covered elsewhere<sup class="footnote"><a href="#fn1">1</a></sup>.</p>
+--- 
+name: footnote
+desc: To create the footnote that corresponds to its reference within the text, begin a new paragraph with fn and the footnote&#8217;s number, followed by a dot and a space.
+in: fn1. Down here, in fact.
+html: <p class="footnote" id="fn1"><sup>1</sup> Down here, in fact.</p>
+--- 
+name: em
+desc: Emphasis to text is added by surrounding a phrase with underscores.  In HTML, this often appears as <em>italics</em>.
+in: I _believe_ every word.
+html: <p>I <em>believe</em> every word.</p>
+lite_mode_html: "I <em>believe</em> every word."
+--- 
+name: strong
+desc: Strength can be give to text by surrounding with asterisks.  In HTML, this strength appears as <strong>bold</strong>.
+in: And then? She *fell*!
+html: <p>And then? She <strong>fell</strong>!</p>
+lite_mode_html: "And then? She <strong>fell</strong>!"
+--- 
+name: force bold italics
+desc: Both italics and bold can be forced by doubling the underscores or asterisks.
+in: |-
+  I __know__.
+  I **really** __know__.
+html: |-
+  <p>I <i>know</i>.<br />
+  I <b>really</b> <i>know</i>.</p>
+--- 
+name: citation
+desc: Use double question marks to indicate <em>citation</em>.  The title of a book, for instance.
+in: ??Cat's Cradle?? by Vonnegut
+html: <p><cite>Cat&#8217;s Cradle</cite> by Vonnegut</p>
+--- 
+name: code phrases
+desc: Code phrases can be surrounded by at-symbols.
+in: Convert with @r.to_html@
+html: <p>Convert with <code>r.to_html</code></p>
+lite_mode_html: Convert with <code>r.to_html</code>
+---
+name: code phrases not created with multiple email addresses
+in: Please email why@domain.com or jason@domain.com.
+html: <p>Please email why@domain.com or jason@domain.com.</p>
+--- 
+name: del
+desc: To indicate a passage which has been deleted, surround the passage with hypens.
+in: I'm -sure- not sure.
+html: <p>I&#8217;m <del>sure</del> not sure.</p>
+--- 
+name: ins
+desc: Pluses around a passage indicate its insertion.
+in: You are a +pleasant+ child.
+html: <p>You are a <ins>pleasant</ins> child.</p>
+--- 
+name: superscript
+desc: To superscript a phrase, surround with carets.
+in: a ^2^ + b ^2^ = c ^2^
+html: <p>a <sup>2</sup> + b <sup>2</sup> = c <sup>2</sup></p>
+--- 
+name: subscript
+desc: To subscript, surround with tildes.
+in: log ~2~ x
+html: <p>log <sub>2</sub> x</p>
+--- 
+name: span
+desc: Lastly, if you find yourself needing to customize the style of a passage, use percent symbols to translate the passage as an HTML span.
+in: I'm %unaware% of most soft drinks.
+html: <p>I&#8217;m <span>unaware</span> of most soft drinks.</p>
+--- 
+name: style span
+desc: This way, you can apply style settings, as described in the next section to arbitrary phrases.
+in: |-
+  I'm %{color:red}unaware%
+  of most soft drinks.
+html: |-
+  <p>I&#8217;m <span style="color:red;">unaware</span><br />
+  of most soft drinks.</p>
+lite_mode_html: |-
+  I&#8217;m <span style="color:red;">unaware</span><br />
+  of most soft drinks.
+--- 
+name: css class
+desc: A block can be tagged with a CSS class by circling the class in parentheses and placing it just before the period which marks the block.
+in: p(example1). An example
+html: <p class="example1">An example</p>
+--- 
+name: css id
+desc: An element ID can be given by prefixing the ID with a pound symbol and using it in place of the class.
+in: p(#big-red). Red here
+html: <p id="big-red">Red here</p>
+--- 
+name: class and id combined
+desc: Class and ID can be combined by placing the class first.
+in: p(example1#big-red2). Red here
+html: <p class="example1" id="big-red2">Red here</p>
+--- 
+name: css style
+desc: Style settings can be provided directly by surrounding them in curly braces.
+in: p{color:blue;margin:30px}. Spacey blue
+html: <p style="color:blue;margin:30px;">Spacey blue</p>
+--- 
+name: language designations
+desc: Language designations can be given between angel brackets.
+in: p[fr]. rouge
+html: <p lang="fr">rouge</p>
+--- 
+name: block attributes on phrase modifiers
+desc: All block attributes can be applied to phrases as well by placing them just inside the opening modifier.
+in: |-
+  I seriously *{color:red}blushed*
+  when I _(big)sprouted_ that
+  corn stalk from my
+  %[es]cabeza%.
+html: |-
+  <p>I seriously <strong style="color:red;">blushed</strong><br />
+  when I <em class="big">sprouted</em> that<br />
+  corn stalk from my<br />
+  <span lang="es">cabeza</span>.</p>
+--- 
+name: inline attributes preceded by text are treated as literal
+desc: modifiers must come first, without anything before them
+in: |-
+  I *seriously {color:red}blushed*
+  when I _first (big)sprouted_ that
+  corn stalk from my
+  %grande [es]cabeza%.
+html: |-
+  <p>I <strong>seriously {color:red}blushed</strong><br />
+  when I <em>first (big)sprouted</em> that<br />
+  corn stalk from my<br />
+  <span>grande [es]cabeza</span>.</p>
+--- 
+name: align justified
+desc: Text inside blocks can be aligned in four basic ways.
+in: p<>. justified
+html: <p style="text-align:justify;">justified</p>
+--- 
+name: indentation
+desc: Indentation can also be specified by provide a single left paren for every 1em to the left.  A single right paren for every 1em to the right.
+in: p))). right ident 3em
+html: <p style="padding-right:3em;">right ident 3em</p>
+--- 
+name: indentation and alignment
+desc: Identation may be coupled with alignment.
+in: h2()>. Bingo.
+html: <h2 style="padding-left:1em;padding-right:1em;text-align:right;">Bingo.</h2>
+--- 
+name: many modifiers combined
+desc: And, furthermore, coupled with language settings and CSS styles.
+in: h3()>[no]{color:red}. Bingo
+html: <h3 style="padding-left:1em;padding-right:1em;text-align:right;color:red;" lang="no">Bingo</h3>
+--- 
+name: code blocks
+desc: For example, long code blocks belong between <code>pre</code> and <code>code</code> tags.  Please also indent your code inside the tags to be sure that all Textile processors out there will ignore the contents.
+in: |
+  <pre>
+  <code>
+    a.gsub!( /</, '' )
+  </code>
+  </pre>
+html: |-
+  <pre>
+  <code>
+    a.gsub!( /&lt;/, '' )
+  </code>
+  </pre>
+--- 
+name: div tags
+desc: You may also choose to surround sections with <code>div</code> tags to separate your document into sections. <a href="http://www.instiki.org/">Instiki</a> uses this technique to float a sidebar to the right.
+in: |
+  <div style="float:right;">
+  
+  h3. Sidebar
+  
+  "Hobix":http://hobix.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/">Hobix</a><br />
+  <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>
+--- 
+name: numbered list
+desc: To make a numbered list, place each item in its own paragraph, preceded by &#8221;#&#8221;.
+in: |-
+  # 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>
+--- 
+name: nested numbered lists
+desc: These lists may be nested by increasing the number of pound symbols preceding child entries.
+in: |-
+  # 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>
+--- 
+name: bulleted list
+desc: Bulleted lists use an asterisk in place of the pound.
+in: |-
+  * 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>
+--- 
+name: nested bulleted lists
+desc: These lists may be nested in like manner.
+in: |-
+  * 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>
+--- 
+name: links
+desc: Basic links are comprised of a phrase which is linked to a <acronym title="Universal Resource Locator">URL</acronym>.  Place the descriptive phrase in quotation marks.  Follow it immediately by a colon and the URL.
+in: I searched "Google":http://google.com.
+html: <p>I searched <a href="http://google.com">Google</a>.</p>
+lite_mode_html: I searched <a href="http://google.com">Google</a>.
+--- 
+name: link aliases
+desc: If you are using the same link several times in your document, or you’d just like to be a tad more organized, you can use a link alias.  Place the URL anywhere in your document, beginning with its alias in square brackets.  Then, use the alias in place of the URL, using the link format above.
+in: |-
+  I am crazy about "Hobix":hobix
+  and "it's":hobix "all":hobix I ever
+  "link to":hobix!
+  
+  [hobix]http://hobix.com
+html: |-
+  <p>I am crazy about <a href="http://hobix.com">Hobix</a><br />
+  and <a href="http://hobix.com">it&#8217;s</a> <a href="http://hobix.com">all</a> I ever<br />
+  <a href="http://hobix.com">link to</a>!</p>
+--- 
+name: image
+desc: You can embed an image in your Textile document by surrounding its URL with exclamation marks.
+in: "!http://hobix.com/sample.jpg!"
+html: <p><img src="http://hobix.com/sample.jpg" alt="" /></p>
+lite_mode_html: <img src="http://hobix.com/sample.jpg" alt="" />
+--- 
+name: image title
+desc: A title for the image can also be provided in parens, just before the closing exclamation.
+in: "!openwindow1.gif(Bunny.)!"
+html: <p><img src="openwindow1.gif" title="Bunny." alt="Bunny." /></p>
+--- 
+name: image links
+desc: Links can be attached to images with a colon.
+in: "!openwindow1.gif!:http://hobix.com/"
+html: <p><a href="http://hobix.com/"><img src="openwindow1.gif" alt="" /></a></p>
+--- 
+name: image alignments
+desc: Alignments can be applied as well to images.
+in: |-
+  !>obake.gif!
+  
+  And others sat all round the small
+  machine and paid it to sing to them.
+html: |-
+  <p style="float:right;"><img src="obake.gif" alt="" /></p>
+  <p>And others sat all round the small<br />
+  machine and paid it to sing to them.</p>
+--- 
+name: acronym definitions
+desc: Definitions for acronyms can be provided by following an acronym with its definition in parens.
+in: We use CSS(Cascading Style Sheets).
+html: <p>We use <acronym title="Cascading Style Sheets"><span class="caps">CSS</span></acronym>.</p>
+lite_mode_html: We use <acronym title="Cascading Style Sheets"><span class="caps">CSS</span></acronym>.
+no_span_caps_html: <p>We use <acronym title="Cascading Style Sheets">CSS</acronym>.</p>
+--- 
+name: tables
+desc: Simple tables can be built by separating fields with pipe characters
+in: |-
+  | name | age | sex |
+  | joan | 24 | f |
+  | archie | 29 | m |
+  | bella | 45 | f |
+html: |-
+  <table>
+  	<tr>
+  		<td> name </td>
+  		<td> age </td>
+  		<td> sex </td>
+  	</tr>
+  	<tr>
+  		<td> joan </td>
+  		<td> 24 </td>
+  		<td> f </td>
+  	</tr>
+  	<tr>
+  		<td> archie </td>
+  		<td> 29 </td>
+  		<td> m </td>
+  	</tr>
+  	<tr>
+  		<td> bella </td>
+  		<td> 45 </td>
+  		<td> f </td>
+  	</tr>
+  </table>
+--- 
+name: table headers
+desc: Specify header cells by marking them with an underscore and period.
+in: |-
+  |_. name |_. age |_. sex |
+  | joan | 24 | f |
+  | archie | 29 | m |
+  | bella | 45 | f |
+html: |-
+  <table>
+  	<tr>
+  		<th>name </th>
+  		<th>age </th>
+  		<th>sex </th>
+  	</tr>
+  	<tr>
+  		<td> joan </td>
+  		<td> 24 </td>
+  		<td> f </td>
+  	</tr>
+  	<tr>
+  		<td> archie </td>
+  		<td> 29 </td>
+  		<td> m </td>
+  	</tr>
+  	<tr>
+  		<td> bella </td>
+  		<td> 45 </td>
+  		<td> f </td>
+  	</tr>
+  </table>
+--- 
+name: table cell attributes
+desc: The period used above marks the end of a cell’s attributes.  Other attributes can be applied as well.
+in: |-
+  |_. attribute list |
+  |<. align left |
+  |>. align right|
+  |=. center |
+  |<>. justify |
+  |^. valign top |
+  |~. bottom |
+html: |-
+  <table>
+  	<tr>
+  		<th>attribute list </th>
+  	</tr>
+  	<tr>
+  		<td style="text-align:left;">align left </td>
+  	</tr>
+  	<tr>
+  		<td style="text-align:right;">align right</td>
+  	</tr>
+  	<tr>
+  		<td style="text-align:center;">center </td>
+  	</tr>
+  	<tr>
+  		<td style="text-align:justify;">justify </td>
+  	</tr>
+  	<tr>
+  		<td style="vertical-align:top;">valign top </td>
+  	</tr>
+  	<tr>
+  		<td style="vertical-align:bottom;">bottom </td>
+  	</tr>
+  </table>
+--- 
+name: table colspan
+desc: You can also specify colspans with a backslash, followed by the cell width.
+in: |-
+  |\2. spans two cols |
+  | col 1 | col 2 |
+html: |-
+  <table>
+  	<tr>
+  		<td colspan="2">spans two cols </td>
+  	</tr>
+  	<tr>
+  		<td> col 1 </td>
+  		<td> col 2 </td>
+  	</tr>
+  </table>
+--- 
+name: table rowspan
+desc: Rowspan is specified by a forward slash, followed by the row height.
+in: |-
+  |/3. spans 3 rows | a |
+  | b |
+  | c |
+html: |-
+  <table>
+  	<tr>
+  		<td rowspan="3">spans 3 rows </td>
+  		<td> a </td>
+  	</tr>
+  	<tr>
+  		<td> b </td>
+  	</tr>
+  	<tr>
+  		<td> c </td>
+  	</tr>
+  </table>
+--- 
+name: block attributes applied to table cells
+desc: All block attributes can be applied to table cells as well.
+in: "|{background:#ddd}. Grey cell|"
+html: |-
+  <table>
+  	<tr>
+  		<td style="background:#ddd;">Grey cell</td>
+  	</tr>
+  </table>
+--- 
+name: black attributes applied to a table
+desc: Table-wide attributes can be applied before the first row of the table.  On its own line, followed by a period.
+in: |-
+  table{border:1px solid black}.
+  |This|is|a|row|
+  |This|is|a|row|
+html: |-
+  <table style="border:1px solid black;">
+  	<tr>
+  		<td>This</td>
+  		<td>is</td>
+  		<td>a</td>
+  		<td>row</td>
+  	</tr>
+  	<tr>
+  		<td>This</td>
+  		<td>is</td>
+  		<td>a</td>
+  		<td>row</td>
+  	</tr>
+  </table>
+--- 
+name: black attributes applied to a table row
+desc: Attributes can be applied to a single row by supplying the attribute before the row starts, using a <code>table</code> modifier and following it by a period.
+in: |-
+  |This|is|a|row|
+  {background:#ddd}. |This|is|grey|row|
+html: |-
+  <table>
+  	<tr>
+  		<td>This</td>
+  		<td>is</td>
+  		<td>a</td>
+  		<td>row</td>
+  	</tr>
+  	<tr style="background:#ddd;">
+  		<td>This</td>
+  		<td>is</td>
+  		<td>grey</td>
+  		<td>row</td>
+  	</tr>
+  </table>
+---
+name: extended block followed by pre block
+in: |-
+  div.. Just a test.
+  
+  Second div.
+  
+  pre. A pre block ends it.
+html: |-
+  <div>Just a test.</div>
+  <div>Second div.</div>
+  <pre>A pre block ends it.</pre>
+---
+name: extended block followed by blockquote
+in: |-
+  div.. Just a test.
+
+  Second div.
+
+  bq. A blockquote ends it.
+html: |-
+  <div>Just a test.</div>
+  <div>Second div.</div>
+  <blockquote>
+  <p>A blockquote ends it.</p>
+  </blockquote>
+---
+name: extended block followed by block code
+in: |-
+  div.. Just a test.
+
+  Second div.
+
+  bc. A blockcode ends it.
+html: |-
+  <div>Just a test.</div>
+  <div>Second div.</div>
+  <pre><code>A blockcode ends it.</code></pre>
+---
+name: extended block followed by notextile block
+in: |-
+  div.. Just a test.
+
+  Second div.
+
+  notextile. A notextile block ends it.
+html: |-
+  <div>Just a test.</div>
+  <div>Second div.</div>
+  A notextile block ends it.
+valid_html: false
+---
+name: simple parentheses
+in: |-
+  before (in parens) after
+html: |-
+  <p>before (in parens) after</p>
+---
+name: parentheses in underscores
+in: |-
+  before _(in parens)_ after
+html: |-
+  <p>before <em>(in parens)</em> after</p>
+---
+name: parentheses in asterisks
+in: |-
+  before *(in parens)* after
+html: |-
+  <p>before <strong>(in parens)</strong> after</p>
+---
+name: parentheses in underscores in quotes
+in: |-
+  "before _(in parens)_ after"
+html: |-
+  <p>&#8220;before <em>(in parens)</em> after&#8221;</p>
+---
+name: underscores in parentheses
+in: |-
+   one _two three_ (four _five six_) seven
+html: |-
+  <p>one <em>two three</em> (four <em>five six</em>) seven</p>
+---
+name: underscores in parentheses in quotes
+in: |-
+   "one _two three_ (four _five six_) seven"
+html: |-
+  <p>&#8220;one <em>two three</em> (four <em>five six</em>) seven&#8221;</p>
+---
+name: underscores in parentheses 2
+in: |-
+   one (two _three four_) five
+html: |-
+  <p>one (two <em>three four</em>) five</p>
+---
+name: underscores in parentheses in quotes 2
+in: |-
+   "one (two _three four_) five"
+html: |-
+  <p>&#8220;one (two <em>three four</em>) five&#8221;</p>