Markup Languages

Markdown is a markup language with a simple text syntax designed so that it can be converted to HTML and many other formats. Markdown is often used to format README files, to write posts in discussion forums, and to create formatted text using a plain text editor.

John Gruber, with substantial input from Aaron Swartz, created the Markdown language in 2004 with the goal of enabling people “to write using a text format that is easy to write and read and, optionally, to convert it to structurally sound XHTML (or HTML).” Taking its cues from existing conventions for writing plain text in emails, such as setext, the language is designed to be readable as is, without appearing to be marked up with tags or formatting instructions,[8] unlike text formatted with a markup language such as Rich Text Format (RTF) or HTML, which clearly display formatting instructions. Markdown is used, for example, for README files on GitHub.

markdown project

github dialect

Markdown Cheatsheet

Hugo MarkDown Syntax

Headings

# This is an <h1> tag
## This is an <h2> tag
### This is an <h3> tag
###### This is an '<h6> tag

This is an \PROTECT_HTML_TAG_26__ tag

This is an \PROTECT_HTML_TAG_27__ tag

This is an \PROTECT_HTML_TAG_28__ tag

This is an \PROTECT_HTML_TAG_29__ tag

Emphasis

*This text will be italic*
_This will also be italic_

**This text will be bold**
__This will also be bold__

_You **can** combine them_

This text will be italic This will also be italic

This text will be bold This will also be bold

You can combine them

Line interruptions and returns

Paragraphs are divided by a blank line ( i.e., two line breaks).

To wrap while staying in the same paragraph, insert two spaces before of going to the head and continuing to write. This is a separate line in the same paragraph.

Lists

Do not order

* Item 1
* Item 2
  * Item 2a
  * Item 2b
  • Item 1
  • Item 2
    • Item 2a
    • Item 2b

Ordered

1. Item 1
1. Item 2
1. Item 3
   1. Item 3a
   1. Item 3b
  1. Item 1
  2. Item 2
  3. Item 3
    1. Item 3a
    2. Item 3b
1. First ordered list item
2. Another item
⋅⋅* Unordered sub-list. 
1. Actual numbers don't matter, just that it's a number
⋅⋅1. Ordered sub-list
4. And another item.

⋅⋅⋅You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown).

* Unordered list can use asterisks
- Or minuses
+ Or pluses
  1. First ordered list item
  2. Another item ⋅⋅* Unordered sub-list.
  3. Actual numbers don’t matter, just that it’s a number ⋅⋅1. Ordered sub-list
  4. And another item.

⋅⋅⋅You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we’ll use three here to also align the raw Markdown).

  • Unordered list can use asterisks
  • Or minuses
  • Or pluses

Images

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)
[GitHub](http://github.com)

GitHub

Quotes

As Kanye West said:

> We're living the future so
> the present is our past.

As Kanye West said:

We’re living the future so the present is our past.

Inline code

I think you should use an
`<addr>` element here instead.

I think you should use an <addr> element here instead.

Code blocks

Enclose code between 3 inverted superscripts ```
In alternativa rientrare il testo con 4 spazi

var s = "JavaScript syntax highlighting";
alert(s);
s = "Python syntax highlighting"
print s
No language indicated, so no syntax highlighting.
But let's throw in a <b>tag</b>.

Estensioni Github

Github usa una variante (“dialetto”) di Markdown con alcune estensioni: illuminazione sintassi, liste di tasks, tabelle, collegamenti automatici

collegamenti automatici

http://github.com - automatic!

Tabelle

Si separano le colonne con | e l’intestazione dalle altre righe con almeno tre -

First Header | Second Header
------------ | -------------   
Content from cell 1 | Content from cell 2
Content in the first column | Content in the second column

diventa

First HeaderSecond Header
Content from cell 1Content from cell 2
Content in the first columnContent in the second column

Liste di compiti o di controlli

(tasklists, checklists)

- [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> supported
- [x] list syntax required (any unordered or ordered list supported)
- [x] this is a complete item
- [ ] this is an incomplete item

diventa

  • @mentions, #refs, links, formatting, and tags supported
  • list syntax required (any unordered or ordered list supported)
  • this is a complete item
  • this is an incomplete item

Esempi

It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [link to Google!](http://google.com)

It’s very easy to make some words bold and other words italic with Markdown. You can even link to Google!

Sometimes you want numbered lists:

1. One
2. Two
3. Three

Sometimes you want bullet points:

* Start a line with a star
* Profit!

Alternatively,

- Dashes work just as well
- And if you have sub points, put two spaces before the dash or star:
  - Like this
  - And this

Sometimes you want numbered lists:

  1. One
  2. Two
  3. Three

Sometimes you want bullet points:

  • Start a line with a star
  • Profit!

Alternatively,

  • Dashes work just as well
  • And if you have sub points, put two spaces before the dash or star:
    • Like this
    • And this
# Structured documents

Sometimes it's useful to have different levels of headings to structure your documents.Start lines with a `#` to create headings.Multiple `##` in a row denote smaller heading sizes.

### This is a third-tier heading

You can use one `#` all the way up to `######` six for different heading sizes.

If you'd like to quote someone, use the > character before the line:

> Coffee. The finest organic suspension ever devised... I beat the Borg with it.
> - Captain Janeway

Structured documents

Sometimes it’s useful to have different levels of headings to structure your documents.Start lines with a # to create headings.Multiple ## in a row denote smaller heading sizes.

This is a third-tier heading

You can use one # all the way up to ###### six for different heading sizes.

If you’d like to quote someone, use the > character before the line:

Coffee. The finest organic suspension ever devised… I beat the Borg with it.

  • Captain Janeway

Tools

The vim editor supports markdown with syntax illumination and the preview with the instant-markdown plugin https://github.com/suan/vim-instant-markdown

Among the specialized editors ReText and Remarkable