✅ Come scrivere con Markdown e le sue differenze con HTML.

Sommario

,
, ecc, dall'intestazione.
In Markdown è molto semplice, devi semplicemente inserire il carattere numerico (#) come prefisso all'intestazione, più di questi hanno il grado più basso l'intestazione sarà fino ad un massimo di 6.
Ad esempio un'intestazione

Sintassi con triplo backtick

Sintassi di pre-spaziatura

Cos'è Markdown?
È definito tanto quanto il software scritto in Perl, che converte il testo scritto in HTML e, inoltre, nella sintassi utilizzata per raggiungere il risultato HTML che ci aspettiamo. Una sintassi pensata per essere semplice per chiunque voglia scrivere sul web, senza bisogno di saperlo.
Oggi la maggior parte dei gestori di contenuti e anche molti client di posta supportano l'uso della sintassi Markdown, in modo nativo, con l'intento di facilitare la creazione di testo formattato senza la necessità di implementare stili o conoscere l'HTML. . Questi gestori utilizzano un parser per convertire il testo Markdown in HTML.
MarkDown e documentazione
È molto utile imparare molti strumenti di documentazione da markdown; wikia, onenote, evernote, alfresco lo supportano in modo nativo o con l'aiuto di terze parti. È importante avere la documentazione dei processi e dei possibili problemi, ma ancora più importante è mantenerla ordinata e pulita anche dalla console e il markdown è qui per aiutarci.
paragrafi
Se stessimo scrivendo normalmente in un comune editor, per definire un paragrafo basterebbe premere un paio di:

accedere

E vedremo il nostro cursore andare un paio di righe sotto per scrivere in un nuovo paragrafo.
In HTML è noto come
di paragrafo.
In Markdown è facile come in un normale editor.
Inoltre abbiamo il vantaggio che una singola interruzione di riga non separa il testo in più righe, se scriviamo qualcosa del genere:
Un testo. Un altro testo.
Apparirà così:
Un testo. Un altro testo.
L'uso di più linee di separazione si riduce allo stesso modo a un singolo spazio separatore tra i paragrafi
intestazioni
In un normale editor avremmo bisogno della barra degli strumenti per definire uno stile di intestazione per un testo, oppure se ti senti un po' disordinato basterebbe salire alla dimensione del carattere e renderlo in grassetto.
In HTML sono conosciuti come
,
, ecc, dall'intestazione.
In Markdown è molto semplice, devi semplicemente inserire il carattere numerico (#) come prefisso all'intestazione, più di questi hanno il grado più basso l'intestazione sarà fino ad un massimo di 6.
Ad esempio un'intestazione (il più grande) e uno sarebbero scritti così:
# Intestazione grande ### Intestazione piccola
e il risultato sarà così.

Grande intestazione
Intestazione piccola
separatori
Normalmente non è possibile disegnare separatori in semplici editor.

INGRANDIRE

In HTML diventano di regole orizzontali.
Sono delimitati digitando 3 o più asterischi o trattini. Possono essere seguiti o separati da uno spazio, è indifferente.
* * * *** - - - ---
enfasi
Questa formattazione è nota come corsivo e grassetto.
In HTML sarebbe sì .
Per creare un testo con formato corsivo, devi solo racchiudere il testo tra singoli asterischi o trattini bassi e per il grassetto tra doppi:
* testo in corsivo. * _ testo in corsivo._ ** testo in grassetto. ** __testo in grassetto .__
Sarebbe simile a questo:
testo in corsivo. testo grassetto.
Barrato
Questo ti permette di posizionare il testo come se lo stessimo cancellando, usato molto per il controllo della versione. o Bug corretti in un'applicazione o in un sistema.
IN HTML sarebbe da barrato.
È sufficiente racchiudere il testo tra doppie maiuscole o tilde:
~~ testo barrato. ~~
Questa opzione non è uno standard e potrebbe non funzionare in tutti gli editor.
Citazioni
Lo stile di citazione di solito non si trova facilmente in un comune editor di testo
In HTML sarebbe
.
Non ci resta che inserire il carattere "maggiore di" (>) come prefisso al testo che segue (simile all'indirizzamento in linux)
> Questa è una citazione.
Sembrerebbe:

Questa è una citazione.

Elenchi
Per definire un elenco di obiettivi usiamo solitamente la funzionalità di elenchi puntati per elenchi senza ordine specifico e elenchi numerati.
In HTML sarebbe per gli elenchi non ordinati, per liste ordinate e per definire ogni elemento nell'elenco.
In Markdown li definiamo semplicemente anteponendo a ciascun elemento un asterisco (*), un trattino (-) o il simbolo più (+) per gli elenchi non ordinati. Per le liste ordinate precediamo con il numero corrispondente e un punto:
* Scrivi tutorial * Pubblicalo in Solvetic. 1. Nuovo tutorial. 3. Scegli una sezione e un livello. 2. Correggere i formati e pubblicare.
Sembrerebbe questo:

Scrivi tutorial.

Pubblicalo su Solvetic.

Nuovo tutorial.

Scegli una sezione e un livello.

Formati corretti e pubblicare.

Negli elenchi enumerati non viene rispettata la gerarchia del numero, verrà utilizzata la posizione al loro interno.
Link
Il posizionamento dei collegamenti è estremamente utile e importante poiché consente di fare riferimento al contenuto a una documentazione esterna o a un tutorial.
Esempio:
Il server Nginx è stato protetto con fail2ban utilizzando [tutorial-solvetic] (http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx/)
Mettiamo tra parentesi [] il testo che vogliamo ha il link e poi lo mettiamo tra parentesi () il collegamento di destinazione.
Se preferisci farlo in modo più ordinato che avere i riferimenti nel mezzo del tuo testo, puoi farlo anche nel seguente modo:
Il server Nginx è stato protetto con fail2ban utilizzando [1]……… [1]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx /
Un'altra opzione sarebbe:
Il server Nginx è stato protetto con fail2ban utilizzando [fail2ban-nginx-solvetic]……… [ssh-nginx-solvetic]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo - con-ssh-y-nginx /
Ora aggiungi le immagini.
immagini
Possiamo aggiungere immagini quasi simili ai link aggiungendo un! Prima di ognuno, devo sottolineare di non poterli vedere da un terminale, beh non direttamente.
! [testo alternativo] (image-url)
Possiamo usare le stesse opzioni dei link se vogliamo averlo più organizzato.
tavole
Di solito inserisco i dati di accesso in tabelle di server o servizi.
Per fare ciò, disegniamo le righe della tabella con le barre (|) per delimitare le colonne e i trattini (-) per separare l'intestazione dal resto delle righe:
| Servizio | Utente | Tasto | | ------------- | --------- | ----------- | | FTP | solvetic | aw-D.wak | | SSH | admin | 2 -.- am, |
Avremmo qualcosa del genere:

I tubi non devono essere allineati e i "bordi" sono opzionali, ad esempio:
Titolo 1 | Titolo 2 --- | --- proviamo | qualcosa proviamone un po' | qualcos'altro.Questo genererebbe la stessa tabella.
Puoi anche allineare il testo nelle tue colonne posizionando il simbolo dei due punti ( sul separatore formato da trattino sul lato che vuoi allineare:
| Allineato a sinistra. | Centrato | Allineato a destra. | |: ------------------- |: --------: | ----------------- -: | | prova | prova | prova |
Non tutti gli editor accettano tabelle in Markdown.
Codice
Possiamo evidenziare il nostro codice con markdown e differisce da una lingua all'altra.
Sintassi con triplo backtick

Posizionare questo tipo di blocchi è molto semplice, dobbiamo solo allegare il blocco di codice che vogliamo inserire.e 3 apici inversi (`` ``) seguito dal nome della lingua a cui appartiene il codice che si vuole inserire:
`` `lingua x = y …` ``
Un esempio di codice JavaScript sarebbe simile a questo:
`` `` js function test() {console.log ('testing!')} ''
Questo genererebbe un bel blocco di codice con la sintassi evidenziata per javascript:
test funzione () {console.log ('testing!')}

Sintassi di pre-spaziatura

Un altro modo per inserire testo o codice preformattato ma senza una lingua specificata è "indentare" il nostro testo con 4 spazi, lo scriveremmo in questo modo:
x = y // nota che ci sono 4 spazi tra il margine e ciò che scriviamo.
avremo questo risultato:
x = y // nota che ci sono 4 spazi tra il margine e ciò che scriviamo.
La norma accetta solo l'opzione con prespaziatura.
ConclusioniUn buon sistema di documentazione deve essere veloce, flessibile e semplice. Punti che il markdown copre in modo molto buono, non dobbiamo dimenticare la sua sintassi pulita per gli occhi, qualcosa da tenere in considerazione se vogliamo rivedere la documentazione da un terminale utilizzando VIM / EMACS. La voce ha un approccio per gli amministratori di sistema ma può essere molto utile per tutti i tipi di professionisti o studenti.Spero che ogni dubbio o suggerimento sia stato chiarito, lascialo nei commenti.Ti è piaciuto e hai aiutato questo Tutorial?Puoi premiare l'autore premendo questo pulsante per dargli un punto positivo