mywiki/markdown/markdown.md

210 lines
5.9 KiB
Markdown

# Tutorial Markdown
## Headings
Gli headings si ottengono con il carattere `#`. Più cancelletti vengono inseriti, più piccolo sara l'heading.
```md
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
```
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
---
## Liste
Per le *liste ordinate*, si utilizzano i numeri, mentre per le *liste non ordinate* i simboli: `-` , `*` o `+`
```md
1. Primo elemento
2. Secondo elemento
3. Terzo elemento
- Elemento
- Elemento
- Elemento
```
## Elementi inline
Il *corsivo* si ottiene inserendo del testo tra un `*` o un `_`
```md
_testo in corsivo con underscore_
*testo in corsivo con asterisco*
```
Il **grassetto** si ottiene inserendo del testo tra due `**` o due `__`
```md
__testo in grassetto con due underscore__
**testo in grassetto con due asterischi**
```
## Le citazioni (Blockquote)
I blockquote o citazioni si ottengono con la parentesi angolare `>`
> Questa è una citazione. Rimango sulla stessa linea.
## Immagini
Le immagini vengono mostrate con la sintassi seguente:
```md
![Descrizione](https://gitea.it/avatars/7eeeb156c6a3d3e5e91b9d848d59165d?size=580 'piccihud')
```
![Descrizione](https://gitea.it/avatars/7eeeb156c6a3d3e5e91b9d848d59165d?size=580 'piccihud')
## Link
Ecco la sintassi per i link:
```md
[Collegamento a Wikipedia.it](https://wikipedia.it 'Vai su wikipedia')
```
[Collegamento a Wikipedia.it](https://wikipedia.it 'Vai su wikipedia')
## Tables
Nelle tabelle, le colonne sono separate dalla pipe `|`, mentre tra la riga d'intestazione e quelle sottostanti si inseriscono una fila `---` separati da pipe per ogni colonna:
```md
| Taglia | Colore |
| ------ | ------ |
| S | Giallo |
| M | Giallo |
| L | Giallo |
| XL | Blu |
```
| Taglia | Colore |
| ------ | ------ |
| S | Giallo |
| M | Giallo |
| L | Giallo |
| XL | Blu |
```md
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
```
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
## Note a piè di pagina
```md
Here is a simple footnote[^1].
A footnote can also have multiple lines[^2].
You can also use words, to fit your writing style more closely[^note].
[^1]: My reference.
[^2]: Every new line should be prefixed with 2 spaces.
This allows you to have a footnote with multiple lines.
[^note]:
Named footnotes will still render with numbers instead of the text but allow easier identification and linking.
This footnote also has been made with a different syntax using 4 spaces for new line
```
## Code snippets
Il codice può essere inserito inline o come blocco.
Per del codice inline basta inserire una o più parole tra backtick:
```md
La root dell'applicazione è nel file `App.js` nella cartella `src`
```
La root dell'applicazione è nel file `App.js` nella cartella `src`
Il codice in blocco può essere racchiuso tra tre backtick. È anche possibile specificare il linguaggio del blocco per una sintassi correttamente evidenziata:
```html
<div class="scrollmenu">
<a href="#home">Home</a>
<a href="#news">News</a>
<a href="#contact">Contact</a>
<a href="#about">About</a>
...
</div>
```
## Editor MarkDown
Uno degli editor migliori per il Markdown è `VSCodium`. Questi i plugin necessari:
- [https://open-vsx.org/vscode/item?itemName=yzhang.markdown-all-in-one](https://open-vsx.org/vscode/item?itemName=yzhang.markdown-all-in-one)
- [https://open-vsx.org/vscode/item?itemName=yzane.markdown-pdf](https://open-vsx.org/vscode/item?itemName=yzane.markdown-pdf)
- [https://open-vsx.org/vscode/item?itemName=DavidAnson.vscode-markdownlint](https://open-vsx.org/vscode/item?itemName=DavidAnson.vscode-markdownlint)
- [https://open-vsx.org/vscode/item?itemName=marp-team.marp-vscode](https://open-vsx.org/vscode/item?itemName=marp-team.marp-vscode)
![MarkDown Plugin VSCodium](./asset/markdown/plugin.png 'Markdown')
Oppure si può utilizzare `Kate`, installando il seguente plugin per avere la preview del file:
[https://apps.kde.org/markdownpart/](https://apps.kde.org/markdownpart/)
```bash
sudo apt update ; sudo apt install -y markdownpart
```
![Preview](./asset/markdown/preview.png 'Preview')
## Numeri e notazione matematiche
Vedere qui: [https://upyesp.org/posts/makrdown-vscode-math-notation/](https://upyesp.org/posts/makrdown-vscode-math-notation/) e anche [https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/](https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/)
## Diagrammi
È possibile utilizzare Mermaid: [https://mermaid.js.org/intro/](https://mermaid.js.org/intro/)
## Presentazioni
Esiste il framework MarpIT: [https://marpit.marp.app/directives](https://marpit.marp.app/directives)
## Licenze
[https://gist.github.com/lukas-h/2a5d00690736b4c3a7ba](https://gist.github.com/lukas-h/2a5d00690736b4c3a7ba)
## Collegamenti
- [https://it.m.wikibooks.org/wiki/Scrivere_in_modo_sostenibile_usando_il_testo_semplice_con_Pandoc_e_Markdown](https://it.m.wikibooks.org/wiki/Scrivere_in_modo_sostenibile_usando_il_testo_semplice_con_Pandoc_e_Markdown)
- [https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/](https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/)
- [https://gist.github.com/lukas-h/2a5d00690736b4c3a7ba](https://gist.github.com/lukas-h/2a5d00690736b4c3a7ba)
- [https://apps.kde.org/it/markdownpart/](https://apps.kde.org/it/markdownpart/)
- [https://www.markdownguide.org/basic-syntax/#images-1](https://www.markdownguide.org/basic-syntax/#images-1)
- [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)