diff --git a/tutorial.txt b/tutorial.md
similarity index 75%
rename from tutorial.txt
rename to tutorial.md
index b290782..708d5a5 100644
--- a/tutorial.txt
+++ b/tutorial.md
@@ -1,25 +1,31 @@
-RuscoMap
+# RuscoMap
-
RuscoMap è una mappa della propria città dove utenti in anonimo possono inserire dei marker con nome, descrizione e foto dell'oggetto abbandonato, segnalandolo a tutti i visitatori della mappa._
-
-Si può trovare o inserire la qualunque purchè ci sia una vaga speranza di riutilizzo, trasformazione o riparazione.
-
-Sulla falsa riga del "_te lo regalo se vieni a prenderlo_", questo è più il "_segnalo che c'è sta roba lì, è tua se te la vai a prendere_"
-
-Navigazione
+Si può trovare o inserire la qualunque purchè ci sia una vaga speranza di riutilizzo, trasformazione o riparazione.
+
+Sulla falsa riga del "_te lo regalo se vieni a prenderlo_", questo è più il "_segnalo che c'è sta roba lì, è tua se te la vai a prendere_"
+
+
+### Navigazione
+
Quando sei sulla mappa, puoi liberamente curiosare tra gli oggetti inseriti
oppure cercare con il form $SOMEWHERE una parola chiave
esempio ricerca: divano. Spariranno tutti i marker rimanendo solo quelli che nel nome o nella descrizione contengono la parola "divano".
-Inserimento
+### Inserimento
+
Cliccando il pulsante in alto a destra (icona marker blu) entri in modalità inserimento.
+
A questo punto cliccando su un punto della mappa inserisci la posizione del nuovo marker.
+
Si aprirà un form dove inserire nome dell'oggetto, una breve descrizione e una foto.
+
Cliccando "Aggiungi marker" il nuovo oggetto comparirà automagicamente sula mappa.
- coordinate: { x: formInputCoordX.value, y: formInputCoordY.value },
- name: '',
- description: "Compila il form per aggiungere un marker qui. Oppure annulla l'inserimento del marker cliccando sulla X in alto a destra",
- filename: null,
\ No newline at end of file
+```
+coordinate: { x: formInputCoordX.value, y: formInputCoordY.value },
+name: '',
+description: "Compila il form per aggiungere un marker qui. Oppure annulla l'inserimento del marker cliccando sulla X in alto a destra",
+filename: null,
+```
\ No newline at end of file