type|wiki

# Syntaxe

Markdown is intended to be as easy-to-read and easy-to-write as is feasible. [Anonymous Contributors, “type|wiki|fr,” (accessed April 1, 2019).](/fr/wiki/start)

Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it's been marked up with tags or formatting instructions. The single biggest source of inspiration for Markdown's syntax is the format of plain text email.

[3]: http://daringfireball.net/projects/markdown/syntax [4]: http://michelf.ca/projects/php-markdown/extra/

To this end, [Markdown's syntax][3] is comprised entirely of punctuation characters, which punctuation characters have been carefully chosen so as to look like what they mean. E.g., asterisks around a word actually look like *emphasis*. Markdown lists look like, well, lists. Even blockquotes look like quoted passages of text, as used in email. The original syntaxe is completed by the complimetary [Markdown Extra][4] which is in use hère.

##Emphasis

• Emphasize* _emphasize_
• *Strong Strong *Emphasize* _emphasize_ Strong Strong ## Other inline style Markdown is pretty limited but HTML is valid Markdown. Here is some useful HTML syntax. ### Striked text <s>Striked text</s> <s>Striked text</s> ### Underlined text <u>Underlined text</u> <u>Underlined text</u> ### Highlighted text <mark>Highlighted text</mark> <mark>Highlighted text</mark> ### Superscrit and subscript H₂O Au 20^e siècle. H₂O Au 20^e siècle. ### Keyboard With the <kbd>cmd</kbd>+<kbd>s</kbd> shortcut. With the <kbd>cmd</kbd>+<kbd>s</kbd> shortcut. ### Sample text Plain text style. Appear in monospace font. <samp>Sample text</samp> <samp>Sample text</samp> ## Liens ### External links A [link](http://example.com “Title”). A [link](http://example.com “Title”). ### Liens à la racine [voici un lien](/syntax.md) [voici un lien](/syntax.md) ### Liens dans la même section Par exemple, pour lier un terme du glossaire, si vous êtes dans le glossaire. [voici un lien](syntax.md) [voici un lien](syntax.md) ### Liens dans une autre section [voici un lien](?id=en/glossary/eye.md) [voici un lien](?id=en/glossary/eye.md) ou [voici un lien](/dokuwiki/en/glossary/eye.md) [voici un lien](/dokuwiki/en/glossary/eye.md) ### Referenced Links Some text with [a link][1] and another [link][2]. [1]: http://example.com/ “Title” [2]: http://example.org/ “Title” Some text with [a link][5] and another [link][6]. [5]: http://example.com/ “Title” [6]: http://example.org/ “Title” The reference section can be anywhere in the document ##Inline Images   The “Alt” text (alternative text) makes images accessible to visually impaired You can use `_media/` as a shorthand for `lib/exe/fetch.php?media=`, so you only need to type ``   ##Referenced Images Smaller logo: ![Alt][1] [1]: /wp-smaller.png “Title” Smaller logo: ![Alt][7] [7]: /wp-smaller.png “Title” ##Linked Images Wrap the entire image markup in a link: [](/dokuwiki/lib/exe/detail.php?media=wiki:directwrite-comparison.png) [](/dokuwiki/lib/exe/detail.php?media=wiki:directwrite-comparison.png) the shorter form is [](/dokuwiki/_media/wiki/directwrite-comparison.png) [](/dokuwiki/_media/wiki/directwrite-comparison.png) You can link to a page or the image itself. ##Footnotes I have more [^1] to say up here. [^1]: To say down here. I have more [^1] to say up here. [^1]: To say down hère. Footnotes will be added to the bottom of the document, with a link back to the original reference ##Line breaks We do not support Markdown’s typical double-space to generate a line break due to our built-in auto-linebreaking function. A regular line break will generate a line break on output. ##Bullet Lists * Item * Item - Item + Item * Item * Item - Item + Item ##Numbered Lists 1. Item 2. Item 1. Item 2. Item ##Mixed Lists 1. Item 2. Item * Mixed * Mixed 3. Item 1. Item 2. Item * Mixed * Mixed 3. Item ##Blockquotes > Quoted text. > > Quoted quote. > * Quoted > * List > Quoted text. > > Quoted quote. > * Quoted > * List ## Preformatted Begin and end each line with two spaces or more to make text look e x a c t l y like you type i t. ##Code `This is code` `This is code` ##Code block ~~~~ This is a piece of code in a block ~~~~ ~~~~ This is a piece of code in a block ~~~~ ``` This too ``` ``` This too ``` ##Syntax highlighting Pas pris en compte ```css #button { border: none; } ``` ```css #button { border: none; } ``` It should work for `actionscript3` — `bash` — `clojure` — `coldfusion` — `cpp` — `csharp` — `css` — `delphi` — `erlang` — `fsharp` — `diff` — `groovy` — `html` — `javascript` — `java` — `javafx` — `matlab` (keywords only) — `objc` — `perl` — `php` — `text` — `powershell` — `python` — `r` — `ruby` — `scala` — `sql` — `vb` — `xml`. ## Headers # Header 1 ## Header 2 {#header2} ### Header 3 {.head} #### Header 4 #### ##### Header 5 ##### ###### Header 6 ###### # Header 1 ## Header 2 {#header2} ### Header 3 {.head} #### Header 4 #### ##### Header 5 ##### ###### Header 6 ###### Closing hash marks are optional on all levels ##Definition Lists Markdown : Text-to-HTML conversion tool Markdown : Text-to-HTML conversion tool Formatting for definition lists may vary between themes ##Abbreviations Markdown converts text to HTML. *[HTML]: HyperText Markup Language Markdown converts text to HTML. *[HTML]: HyperText Markup Language Definitions can be anywhere in the document ##Tables One | Two | Three — | :—: | —: Blue | White | Gray Green | Yellow | Red One | Two | Three | — | :—: | —: Blue | White | Gray | Green | Yellow | Red | The colon in the separator line tells the parser the alignment to apply to the column. Markdown inline is possible. ##Horizontal Rules Three or more dashes or asterisks `—` `*`

—

##Citations

To make citations, use `<cite>` at the beginning of the citation and `</cite>` at the end of the citation.

###Automatic Escaping for Special Characters

In HTML, there are two characters that demand special treatment: `<` and `&`. Left angle brackets are used to start tags; ampersands are used to denote HTML entities. If you want to use them as literal characters, you must escape them as entities, e.g. `<`, and `&`.

Ampersands in particular are bedeviling for web writers. If you want to write about 'AT&T', you need to write '`AT&T`'. You even need to escape ampersands within URLs. Thus, if you want to link to:

  http://images.google.com/images?num=30&q=larry+bird

you need to encode the URL as:

  http://images.google.com/images?num=30&q=larry+bird

in your anchor tag `href` attribute. Needless to say, this is easy to forget, and is probably the single most common source of HTML validation errors in otherwise well-marked-up web sites.

Markdown allows you to use these characters naturally, taking care of all the necessary escaping for you. If you use an ampersand as part of an HTML entity, it remains unchanged; otherwise it will be translated into `&`.

So, if you want to include a copyright symbol in your article, you can write:

  ©

©

and Markdown will leave it alone. But if you write:

  AT&T

AT&T

Markdown will translate it to:

  AT&T

Similarly, because Markdown supports [inline HTML](#html), if you use angle brackets as delimiters for HTML tags, Markdown will treat them as such. But if you write:

  4 < 5

Markdown will translate it to:

  4 < 5

However, inside Markdown code spans and blocks, angle brackets and ampersands are *always* encoded automatically. This makes it easy to use Markdown to write about HTML code. (As opposed to raw HTML, which is a terrible format for writing about HTML syntax, because every single `<` and `&` in your example code needs to be escaped.)

##Backslash Escapes

<a href=“http://example.com/”>http://example.com/</a> Markdown allows you to use backslash escapes to generate literal characters which would otherwise have special meaning in Markdown's formatting syntax. For example, if you wanted to surround a word with literal asterisks (instead of an HTML `<em>` tag), you can use backslashes before the asterisks, like this:

  *literal asterisks*

*literal asterisks*

Markdown provides backslash escapes for the following characters:

     backslash
  `   backtick
  *   asterisk
  _   underscore
  {}  curly braces
  []  square brackets
  ()  parentheses
  #   hash mark
  + plus sign
  - minus sign (hyphen)
  .   dot
  !   exclamation mark