Documentazione

Introduzione

Benvenuto in ghostwriter! Questa guida di riferimento rapido fornisce esempi di scrittura in Markdown, un formato di contrassegno di testo semplice creato da John Gruber. Per ulteriori informazioni, visita il sito web di John Gruber all'indirizzo http://www.daringfireball.net.

ghostwriter ha il supporto integrato per il processore cmark-gfm. Tuttavia, può anche rilevare automaticamente i processori Pandoc, MultiMarkdown o cmark. Installa semplicemente uno di questi processori e assicurati che i loro percorsi di installazione siano aggiunti alla variabile di ambiente PATH del tuo sistema. ghostwriter rileverà automaticamente la loro installazione all'avvio e ti fornirà un'anteprima HTML in diretta e le opzioni di esportazione di conseguenza.

Intestazioni

# Level 1 Heading
## Level 2 Heading ##
###### Level 6 Heading

Level 1 Heading
===============
some text

Level 2 Heading
---------------
some more text

Paragrafi

This is a paragraph.
This is another line in the same paragraph using a manual line break.

This is a new paragraph.

Formattazione in linea

Puoi scrivere in corsivo o anche in grassetto in due modi. Il primo è dicircondando il testo con asterischi (*), mentre il secondo è contrattini bassi (_).

This is *italics* with asterisks.
This is _italics_ with underscores.

This is **bold** with asterisks.
This is __bold__ with underscores.

Puoi anche scrivere in corsivo in grassetto mescolando e abbinando, in questo modo:

This is ***bold italics*** with asterisks.
This is **_bold italics_** mixing.
This is another *__bold italics__*.
etc.

Collegamenti

Puoi collegarti a vari siti web:

Click [here](http://url.com "Title") to visit a website.

Puoi anche utilizzare i collegamenti di riferimento:

[This][id] is a reference link which is defined below.

[id]: http://url.com "Title"

Immagini

Puoi incorporare immagini in questo modo:

![alternate text](./image.jpg "Title")

Puoi anche usare la stessa sintassi dei collegamenti di riferimento:

![alternate text][id] for a reference defined below.

[id]: ./image.jpg "Title"

Elenchi

Puoi utilizzare gli elenchi ordinati:

1. Item one.
2. Item two.
3. Item three.

Oppure puoi utilizzare elenchi non ordinati:

* Item one.
+ Item two.
- Item three.

Puoi combinare e abbinare con elenchi nidificati:

1. Item one.
    * Subitem one.
    * Subitem two.
2. Item two.
    - Subitem one.
    - Subitem two.
3. Item three.
    1. Subitem three.

Blocchi di codice

Puoi rientrare con quattro o più spazi o un carattere di tabulazione per creare un blocco di codice:

This is a normal paragraph, followed by a code block.
    
    for (int i = 0; i < 10; i++) {
        System.out.println("i = " + i);
    }
    
The above will be displayed as a preformatted block of code.

In alcuni convertitori Markdown, come Pandoc o GitHub, puoi usare gli apici inversi della personalizzazione di Markdown di GitHub per delimitare i blocchi di codice invece di rientrare il blocco, in questo modo:

```
for (int i = 0; i < 10; i++) {
    System.out.println("i = " + i);
}
```

Anche quanto sopra verrà visualizzato come un blocco di codice pre-formattato.

Intervalli di codice

Puoi usare gli apici inversi nel mezzo di un paragrafo per delimitare il codice, come con questo tag `<html>`. Puoi usare apici inversi letterali usando più di un apice, come in questo esempio: `` `apice inverso con escape` ``.

Citazioni

È possibile utilizzare le parentesi angolari in stile posta elettronica per delimitare i blocchi di citazione, come segue:

> This is a block quote.
>
>> This is a nested block quote.

Linee orizzontali

Usa tre o più trattini (-), trattini bassi (_) o asterischi (*) per le linee orizzontali, in questo modo:

---

***
___

Puoi anche avere degli spazi tra ogni carattere:

- - -

Estensioni Markdown

Alcuni processori Markdown aggiungono la sintassi per tabelle, note a piè di pagina e così via per estendere la specifica originale Markdown di John Gruber. Di seguito è riportato un esempio di utilizzo delle note a piè di pagina per Pandoc, MultiMarkdown e altri processori che supportano l'estensione:

Here is the body text that has a footnote.[^footnoteid]

[^footnoteid]:  Here is the footnote text.

Di seguito è riportato un esempio di tabella Pandoc:

Column One     Column Two
----------     ----------
Row Text 1     Row Text 2
Row Text 1     Row Text 2

Table:  Pandoc sample table.

Di seguito è riportato un esempio di tabella cmark-gfm o MultiMarkdown:

Column One | Column Two
---------- | ----------
Row Text 1 | Row Text 2
Row Text 1 | Row Text 2

Ci sono ancora più sintassi di tabella che questi processori Markdown possonosupportare. Ci sono anche molte altre estensioni. Per ulteriori informazioni su questi processori, visita i seguenti siti web:

Le specifiche originali Markdown di John Gruber sono disponibili su http://daringfireball.net/projects/markdown/.

Scorciatoie

ghostwriter supporta le seguenti scorciatoie per la modifica di Markdown:

Ctrl+B
Applica la formattazione in grassetto (forte).
Ctrl+I
Applica la formattazione in corsivo (enfasi).
Ctrl+K
Applica la formattazione barrata.
Ctrl+/
Inserisce un commento HTML nella posizione del cursore se non è selezionato alcun testo, altrimenti trasformerà il testo selezionato in un commento HTML.
Tab
Rientra le righe di testo selezionate.
Maiusc+Tab
Annulla il rientro delle righe di testo selezionate.
Maiusc+Invio
Inserisce un'interruzione di riga in stile Markdown.
Ctrl+Invio
Inserisce un'interruzione di riga come al solito, tranne per il fatto che il rientro attuale non sarà rispettato. In altre parole, se stai digitando su una riga rientrata e premi Ctrl+Invio, nessun rientro sarà aggiunto alla nuova riga. Nota che il modificatore Ctrl può essere combinato con il modificatore Maiusc per produrre sia una riga non rientrata che un'interruzione di riga in stile Markdown.
Ctrl+.
Trasforma la riga attuale o le righe selezionate in un blocco di citazione.
Ctrl+,
Rimuove qualsiasi formattazione di blocco di citazione dalla riga attuale o dalle righe di testo selezionate.
Ctrl+8
Trasforma la riga attuale o le righe selezionate in un elenco puntato con l'indicatore *. Ad esempio, se hai selezionato del testo all'interno delle seguenti righe:
  List item one.
  List item two.

Premendo questa scorciatoia si trasformeranno le righe selezionate in un elenco puntato in questo modo:

  * List item one.
  * List item two.
Ctrl+Maiusc+-
Trasforma la riga attuale o le righe selezionate in un elenco puntato con l'indicatore -. Ad esempio, se hai selezionato del testo all'interno delle seguenti righe:
  List item one.
  List item two.

Premendo questa scorciatoia si trasformeranno le righe selezionate in un elenco puntato in questo modo:

  - List item one.
  - List item two.
Ctrl+Maiusc+=
Premendo Ctrl e Maiusc con il carattere = si trasforma la riga attuale o le righe selezionate in un elenco puntato con l'indicatore +. Ad esempio, se hai selezionato del testo all'interno delle seguenti righe:
  List item one.
  List item two.

Premendo questa scorciatoia si trasformeranno le righe selezionate in un elenco puntato in questo modo:

  + List item one.
  + List item two.
Ctrl+1
Trasforma la riga attuale o le righe selezionate in un elenco numerato con l'indicatore .. Ad esempio, se hai selezionato del testo all'interno delle seguenti righe:
  List item one.
  List item two.

Premendo questa scorciatoia si trasformeranno le righe selezionate in un elenco di attività in questo modo:

  1. List item one.
  2. List item two.
Ctrl+0
Trasforma la riga attuale o le righe selezionate in un elenco numerato con l'indicatore ). Ad esempio, se hai selezionato del testo all'interno delle seguenti righe:
  List item one.
  List item two.

Premendo questa scorciatoia si trasformeranno le righe selezionate in un elenco di attività in questo modo:

  1) List item one.
  2) List item two.
Ctrl+T
Trasforma la riga attuale o le righe selezionate in un elemento dell'elenco di attività Markdown dell'implementazione GitHub. Ad esempio, se hai selezionato del testo all'interno delle seguenti righe:
  Important thing to do.
  Another important thing to do.

Premendo questa scorciatoia si trasformeranno le righe selezionate in un elenco di attività in questo modo:

  - [ ] Important thing to do.
  - [ ] Another important thing to do.
Ctrl+D
Quando la riga di testo attuale è un elemento dell'elenco di attività Markdown dell'implementazione GitHub, premendo questo tasto di scelta rapida si alternerà lo stato di completamento dell'attività, inserendo un x nella casella di selezione se l'attività è completa o rimuovendo la x se è incompleta. Ad esempio:
  - [ ] This is an incomplete task.
  - [x] This task as done!
Caratteri corrispondenti
Quando viene selezionato il testo all'interno di una singola riga, la pressione di uno dei caratteri sopra racchiuderà il testo selezionato con quel carattere e il suo carattere di chiusura corrispondente. Ad esempio, se selezioni la parola «cane» e poi inserisci il carattere «(», la parola «cane» sarà racchiusa tra parentesi e diventerà «(cane)». Di seguito è riportata una tabella che mostra il carattere digitato e il corrispondente carattere di chiusura:

AperturaChiusura
""
''
()
[]
{}
**
__
``
<>

Per abilitare la corrispondenza automatica dei caratteri durante la digitazione, marca «Verifica automaticamente i caratteri durante la digitazione» dalla scheda Editor nella finestra Preferenze, disponibile dalla barra dei menu sotto l'opzione «Impostazioni->Preferenze...». Puoi anche personalizzare i caratteri abbinati selezionando il pulsante «Personalizza i caratteri corrispondenti...».
Trascina e rilascia le immagini
Un'alternativa alla selezione dell'opzione «Modifica->Inserisci immagine...» dalla barra dei menu consiste nel trascinare e rilasciare qualsiasi file di immagine dal tuo file system nella finestra dell'editor. L'applicazione inserirà il testo dell'immagine in linea con il percorso del file dell'immagine relativo alla posizione del documento attualmente aperto o il percorso completo se il documento è senza titolo. Ad esempio:

  ![](../../relative/path/to/your/file.png)

o se il documento è senza titolo:

  ![](file:///full/path/to/your/file.png)