liburno_marked

installazione:

npm install liburno_marked

utilizzo:

import {mark,parseinfomd} from "liburno_marked";
...
// opzionale ottiente i metatag
var metatag=parseinfomd(sorgente);
// compila il codice sorgente e lo formatta
var compilato=mark(sorgente);
document.getElementById("main").innerHtml=compilato;

CSS: essendo un fork di marked, il css utilizza le stesse classi di marked.

informazioni:

Questo progetto è un fork di marked. Marked funziona molto bene e l'ho utilizzato per diversi anni senza problemi, ma nell'uso sempre più intensivo di markdown per i miei siti web ho dovuto fare alcune scelte:

Mi serviva un progetto in grado di produrre non solo codice HTML, ma anche PDF.

Ho "esteso" inoltre il linguaggio con alcune nuove funzionalità:

• due colori per i titoli: utilizzo ~colore1~ e ~~colore2~~ per impostare il testo rispettivamente sul colore primario e secondario del sito web. La funzione standard è stata sostituita con ~~~cancella~~~

• supporto youtube: E` possibile integrare un video youtube dispondendo dell'indirizzo come fosse una immagine: il parser riconosce il formato youtube.

• supporto asciimath: ascimath è completamente implementato utilizzando in server dedicato che traduce al volo le formule matematiche grazie a grazie a MathJax

• evidenziatore di sintassi "leggero" liburno_elang

• callback per l'integrazione con VUE: un oggetto markdown può inviare un messaggio (click) ad altri oggetti vue: la sintassi è: [[testo]]

• estensioni sulle immagini per la formattazione e il posizionamento: ![image|50%|mx-auto] per esempio inserisce una immagine con il 50% della larghezza e margini automatici, per il posizionamento al centro..: la sintassi prevede [image|(dimensione)|(classi)]. si ha cosí un miglior controllo sul posizionamneto.

metatag:

è possibile creare alcuni "metatag" all'interno del markdown che non saranno rappresentati nella vista, ma possono servire a raccogliere informazioni sul file MD:

i metatag automatici a dispozione sono (uno per riga e devono iniziare la riga). La sintassi è :<metatag>:<valore>:

• :a: autore
• :e: editore
• :o: titolo originale
• :y: data pubblicazione
• :s: settore
• :t: traduttore
• :u: settore base