Markdown is a wonderfully simple approach to creating web pages, writtenby John Gruber of DaringFireball. You get on with the business of writing (without any fancycode) and Markdown takes care of producing clean, web standardscompliant HTML.
The Daring Fireball site provides full documentation forMarkdown, but the following examplesshould get you started.
- Markdown is a fantastic markup language that compiles into HTML. Although its original implementation was written in Perl, Markdown has been ported into multiple languages with various features.
- TomDoc, Markdown and RD format comments are also supported. You can set the default comment format for your entire project by creating a.rdocoptions file. See Saved Options at RDoc::Options for instructions on creating one.
Section Headings
Ruby Markdown Free
Ruby Webviewer and Editor A nifty markdown notepad site/github: Maruku Ruby Interpreter - github: RDiscount Ruby Binding Ruby binding for Discount github: Redcarpet Ruby Binding Ruby binding for Sundown github: Knockoff Scala -site: Actuarius Scala -site: Lowdown Chicken Scheme Parser library (egg) Can emit SXML chicken wiki, Bitbucket.
You can define headings of different levels when creating a web page.The most important heading (which typically only occurs once on eachpage -- at the top) is heading 1. A level 1 heading can be created withMarkdown by typing a single '#' character at the start of a line. Theheading at the top of this page was defined like this:
To create a secondary heading (such as the one for this section) youjust use two '#' characters, like so:
You can use up to six '#' characters to create a level 6 heading, butyou will probably find that you don't need to nest your headings quiteso deeply!
Paragraphs
Paragraphs are very easy; separate them with a blank line. You can writeyour paragraph on one long line, or you can wrap the lines yourself ifyou prefer.
This section was marked up like so:
Bold and Italics
It's very easy to add emphasis with bold and italics:
You can also use underscores if you prefer:
Links
Create simple links by wrapping square brackets around the link text andround brackets around the URL:
If you want to give your readers an extra about the link that they'reabout to follow you can set a link title:
Titles usually appear as a tooltip when you hover over the link, andhelp search engines work out what a page is about.
Bulleted Lists
Start each line with hyphen or an asterisk, followed by a space. Listitems can be nested. This text:
...produces this list:
- Bullet 1
- Bullet 2
- Bullet 2a
- Bullet 2b
- Bullet 3
Numbered Lists
Start each line with number and a period, then a space. This text…
...produces this list:
- Baked potato
- Baked beans
- Pepper
Quotes
If you need to cite a paragraph of somebody else's work you really oughtto attribute it to them properly by using HTML's <blockquote/>
tag.You can produce it with Markdown by adding a single '>' character atthe beginning of the line.
This text:
...produces:
One thing was certain, that the white kitten had had nothingto do with it -- it was the black kitten's fault entirely. Forthe white kitten had been having its face washed by the old cat,for the last quarter of an hour (and bearing it pretty well,considering) so you see that it couldn't have had any hand inthe mischief. -- Lewis Carroll, Through the LookingGlass
Markdown is a wonderfully simple approach to creating web pages, writtenby John Gruber of DaringFireball. You get on with the business of writing (without any fancycode) and Markdown takes care of producing clean, web standardscompliant HTML.
The Daring Fireball site provides full documentation forMarkdown, but the following examplesshould get you started.
Section Headings
You can define headings of different levels when creating a web page.The most important heading (which typically only occurs once on eachpage -- at the top) is heading 1. A level 1 heading can be created withMarkdown by typing a single '#' character at the start of a line. Theheading at the top of this page was defined like this:
To create a secondary heading (such as the one for this section) youjust use two '#' characters, like so:
You can use up to six '#' characters to create a level 6 heading, butyou will probably find that you don't need to nest your headings quiteso deeply!
Paragraphs
Paragraphs are very easy; separate them with a blank line. You can writeyour paragraph on one long line, or you can wrap the lines yourself ifyou prefer.
This section was marked up like so:
Bold and Italics
It's very easy to add emphasis with bold and italics:
You can also use underscores if you prefer:
Links
Create simple links by wrapping square brackets around the link text andround brackets around the URL:
If you want to give your readers an extra about the link that they'reabout to follow you can set a link title:
Titles usually appear as a tooltip when you hover over the link, andhelp search engines work out what a page is about.
Bulleted Lists
Start each line with hyphen or an asterisk, followed by a space. Listitems can be nested. This text:
...produces this list:
- Bullet 1
- Bullet 2
- Bullet 2a
- Bullet 2b
- Bullet 3
Numbered Lists
Start each line with number and a period, then a space. This text…
...produces this list:
- Baked potato
- Baked beans
- Pepper
Quotes
If you need to cite a paragraph of somebody else's work you really oughtto attribute it to them properly by using HTML's <blockquote/>
tag.You can produce it with Markdown by adding a single '>' character atthe beginning of the line.
Ruby Markdownify
This text:
...produces:
Ruby Markdown Editor
One thing was certain, that the white kitten had had nothingto do with it -- it was the black kitten's fault entirely. Forthe white kitten had been having its face washed by the old cat,for the last quarter of an hour (and bearing it pretty well,considering) so you see that it couldn't have had any hand inthe mischief. -- Lewis Carroll, Through the LookingGlass