Markdown and Multimarkdown testing and documentation


## hidden comments

markdown/multimarkdown permits html style comments.

<!-- this is a comment that remains in the markup but is not displayed to the browser except with a view-source -->


trying something different based upon this post.  
<http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax>

[comment]: <> (This is a comment, it will not be included)
[comment]: <> (in  the output file unless you use it in)
[comment]: <> (a reference style link.)

it worked. the above "comments" do not appear anywhere in the html markup, so they are not seen with a view-source. they could be seen, however, with the "source" command within this app/site at the bottom of this post.

---



**blockquotes**

this is a paragraph.

another paragraph

third paragraph

---

* **bolded**
* *italics*
* ***bolded italics***

<b>using the so-called deprecated HTML command for bolding, this line will be displayed with a yellow background per my CSS.</b> 

---

br. **links**

This is a [link to Toledo Talk.](http://toledotalk.com)

This is a link to [jothut][].

This is a link to [Google][].

[Google]:http://google.com/

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

Okay, now using [JotHut][4] link that way and [this way][4] and finally like this [http://jothut.com][4].

[4][] points to [jothut][] which is also [JotHut.com][jh].

[4]:      http://jothut.com "JR's Blabbing Site"
[jh]:     http://jothut.com "JR's Content Site"
[jothut]: http://jothut.com "JR's Work Site"

`code span line`

the three backticks code fencing does not work in the Perl MultiMarkdown module.

code.I could use my own code block command.

this surrounds text with the code. and code.. commands.
code..




<http://toledotalk.com>

[http://en.wikipedia.org/wiki/MultiMarkdown](http://en.wikipedia.org/wiki/MultiMarkdown)

<http://www.yet.org/2012/10/multimarkdown/>

https://github.com/fletcher/MultiMarkdown/wiki/MultiMarkdown-Syntax-Guide

http://fletcher.github.io/MultiMarkdown-4/MMD_Users_Guide.html

http://michelf.ca/projects/php-markdown/extra/

http://search.cpan.org/~bobtfish/Text-MultiMarkdown-1.000034/lib/Text/MultiMarkdown.pm


multimarkdown=yes

Intro text should go here asdf lj las dflj lj lasjdfl l lasjdflj asldf la jalsj flafl  asldfj alsdf  adflja sdf al df l aldf la dfla dfl aldf ladflajf al fl dfj alksdf la dflk asldf lj aldf ladfslja sfj alsf la flaj sldfj alfs jalf la flja sflj a.

asdlfjl asdjfl klas dfl alsf la sdf alksdf lka dflk adf l faj fj alkdfsj alkdf lakj dflka df afd lafla sflka sfla flk alsfj alfj lak f asdf alf aklflka fkla f asf a dfaj sldfj alkfj .

## heading two

- bullet one
- bullet two

a line of text

1. ordered 1
1. ordered 2
1. ordered 3

another line  
asdf asdf asdf a  
asdfsdf



>   blockquote text asdf  asdflsd flaj dslfja sldfj ladf la sfkl  lajsfljaslf als dfla sdflj aslf jakls dfl adfj alkf kla fklaj dlf alkdf al dfslaj 

and another line

### heading three

will use this space as a sandbox to test Markdown usage.

a line with *italicized text* asdf ljasldfjl

a line **with bolded text** asdf jasdf

escaping asterisk \*so that this is not bolded text\*

<div markdown="0">
to escape a block of text and prevent it from being read as markdown, surround it with a div tag and with an attribute of markdown=0
br. a line with *italicized text* asdf ljasldfjl
br. a line **with bolded text** asdf jasdf
br.  i can still use my custom Textile-like commands anywhere within a this page.
q.
asdfjl alsjdflajsdf las dfl asldf alsfj 
br. asdfasdfasdfasdf
q..
</div>

---

Testing my q. q.. commands again.

q.
This block of text uses the q. and q.. commands.

My q. and q.. commands do not work correctly when the commands surround more than one paragraph.  

here's another paragraph.  

and a third.  

The content is displayed as one paragraph. I believe Textile added the hard breaks.

Adding the two spaces at the end of a paragraph does help.
q..

Another test

<div class="highlighted" markdown="1">
my q. and q.. commands do not work correctly when the commands surround more than one paragraph.

> **This works** (<-bolded text) because instead of using  the q commands, I surrounded this block of text with a div and the class=highlighted along with the attribute markdown="1". 

> The div and the class=highlighted are what the q commands represent. so if use my q commands in the #grebe blogging tool that only supports multimarkdown and not textile, then I need to add the markdown="1" attribute to the formatted output. 

> surrounding the text with the div commands causes more text to display within the blue block area at the top of the block. These three paragraphs are indented with the markdown > command.


</div>
---

## MultiMarkdown Specific Commands


### Some Text ###

Here is as example of [table][simple_table] followed by a more complex [example][reference_table] from the [documentation](https://github.com/fletcher/MultiMarkdown/wiki/MultiMarkdown-Syntax-Guide "MultiMarkdown Syntax Guide")

| First Header | Second Header |         Third Header |  
| :----------- | :-----------: | -------------------: |  
| First row    |      Data     | Very long data entry |  
| Second row   |    **Cell**   |               *Cell* |  
[][simple_table]

|              | Grouping                    ||  
| First Header | Second Header | Third Header |  
| ------------ | :-----------: | -----------: |  
| Content      | *Long Cell*                 ||  
| Content      | **Cell**      | Cell         |  
| New section  | More          | Data         |  
[Prototype table][reference_table]



---

You can place a link to a point in your document like this [one][], or [another][] place in the doc.

## one ##

A simple subheading in a larger document with the same name as the referring tag.

## Another place in the document [another] ##

Another place in the document that is referenced by the [another] tag in the heading



---

line one  
line two



Apple
:   Pomaceous fruit of plants of the genus Malus in 
    the family Rosaceae.
:   another definition.  
  
Orange

:    The fruit of an evergreen tree of the genus Citrus.

---

[Some Text][] link within the document.


---

Here is some text containing a footnote.[^somesamplefootnote]

[^somesamplefootnote]: Here is the text of the footnote itself.




---


    # Demonstrate Syntax Highlighting if you link to highlight.js #
    # http://softwaremaniacs.org/soft/highlight/en/
    print "Hello, world!\n";
    $a = 0;
    while ($a < 10) {
    print "$a...\n";
    $a++;
    }


---

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

---

Apple
:   Pomaceous fruit of plants of the genus Malus in 
    the family Rosaceae.

Orange
:   The fruit of an evergreen tree of the genus Citrus.


### Overview [Introduction] ##

use it:

[Introduction][]



 #markup   - #junco - #multimarkdown