The Markdown language
Markdown is a lightweight markup language created by John Gruber and Aaron Swartz.
It is widely used by developers to write their project's documentation, in internet forum posts and some applications to format the text using a syntax that is easy to read and write.
For example, the following text written in Markdown:
# Hello world!
This is a text written using **Markdown**
Produce el siguiente código HTML:
<h1>Hello world!</h1>
<p>This is a text written using <strong>Markdown</strong></p>
Content
Syntax
Paragraphs and line breaks
In Markdown the paragraphs are one or more consecutive lines of text:
This·is·a·paragraph
<p>This is a paragraph</p>
Line breaks must be preceded by two blank spaces:
This·is·a·paragraph··¶
This·is·another·paragraph
<p>This is a paragraph</p>
<p>This is another paragraph</p>
Otherwise, the text will render in the same paragraph:
This·line·break¶
does·NOT·create·a·new·paragraph
<p>This line break does NOT create a new paragraph</p>
Titles
HTML titles from <h1>
to <h6>
are written as follows:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Alternative Heading 1
=====================
Alternative Heading 2
---------------------
Bold, Italic
*This is a text in italics*
_This is also a text in italics_
**This is a bold text**
__This is also a bold text__
Lists
Unordered lists:
* This is an unordered list
* Lorem ipsum dolot sit amet
* Foo, Bar, Baz
Ordered lists
1. This is an ordered list
2. It can also work by rewriting '1.'
3. Lorem ipsum dolot sit amet
Hyperlinks
[Title](http://example.com)
Images
![Alternative text](https://picsum.photos/250/100?image=10)
Result:
Embedded code
This is a `<span>` HTML tag
Result:
This is a <span>
HTML tag
Block quotations (Blockquote)
> This is a block quote
Result:
This is a block quote
Código HTML
All HTML code inserted in Markdown documents will be rendered as is:
<h1>This <em>should</em> be rendered directly as HTML</h1>
<script>
.
GitHub Flavored Markdown
GitHub Flavored Markdown (GFM) is a Markdown dialect. GFM adds features to the language, such as:
Fenced code blocks
```java System.out.print("This is a code in Java"); ```
Result:
System.out.print("This is a code in Java");
Emojis
This is an emoji in GFM :smiley:
Resultado:
This is an emoji in GFM
Tables
| Heading 1 | Heading 2 | Heading 3 |
| --- | --- | --- |
| Foo | Bar | Lorem |
| Baz | Foobar | Ipsum |
Result:
Heading 1 | Heading 2 | Heading 3 |
---|---|---|
Foo | Bar | Lorem |
Baz | Foobar | Ipsum |