Condividere un file Markdown con un link

Trasforma un file .md in una pagina di sola lettura con un indirizzo da inviare — con password e data di scadenza quando ti servono, il conteggio delle aperture, e un link che puoi chiudere in qualsiasi momento.

Condividi un documento dalla cronologia

Dal file al link

Trascina il file `.md` sul convertitore, oppure incolla il testo nell’anteprima dal vivo e premi Converti e tieni. Da autenticato, premi Salva per conservare il documento nel tuo account, poi Condividi; scegli Chiunque abbia il link e copia l’indirizzo che ricevi: `/s/` e un token che nessuno può indovinare. A chi legge non serve altro: niente account, niente app, niente da installare.

Lì si apre il documento stesso, reso dal nostro server come semplice pagina di sola lettura, con il download del file HTML autonomo e della sorgente Markdown per chi vuole continuare a lavorarci. Le pagine condivise sono servite con `noindex`, quindi restano fuori dai risultati di ricerca, e ognuna ha un link per segnalarla.

Pubblicare un link pubblico richiede un indirizzo email confermato sull’account. La condivisione con persone specifiche funziona in ogni caso.

Una password e una scadenza

Un link può chiedere una password di almeno otto caratteri. Chi lo apre vede un breve modulo prima della pagina, e quel browser ricorda la risposta giusta per un giorno. Dopo dieci tentativi sbagliati in un minuto dalla stessa macchina, o trenta per il link da ovunque insieme, il modulo chiede di aspettare.

La password è conservata solo come hash: si può cambiare o togliere, mai mostrare, e una nuova annulla di colpo tutti gli inserimenti precedenti. Puoi impostarla mentre il documento è ancora privato, così il link è protetto dal momento in cui esiste. Da proprietario autenticato, non ti viene mai chiesta.

Un link può anche finire: tra un’ora, un giorno, sette o trenta giorni, o nel giorno che scegli. Dopo, la pagina e i suoi download dicono che il link è scaduto, e da quando, e anche Salva una copia smette di funzionare. Una nuova scadenza, o nessuna, riapre lo stesso link.

Chi l’ha aperto

La finestra Condividi dice quante volte il link è stato aperto e quando l’ultima volta. La scheda Visualizzazioni, accanto a Controllo, elenca le ultime 200 aperture, dalla più recente e raggruppate per giorno, indicando se è passata dalla pagina condivisa o dall’app.

Conta le aperture, non le persone, e le tue sono tra queste. Per un link che chiunque può aprire non si conserva nulla su chi l’ha aperto: di un’apertura si conservano solo l’ora e se è passata dalla pagina o dall’app, nessun cookie viene impostato per contarla, e i bot che scaricano un link per disegnarne l’anteprima in una chat non vengono contati. Le aperture appartengono al link, quindi revocarlo le cancella, e nessuna è tenuta più di un anno.

Solo per le persone che indichi

Per un documento che non deve circolare, scegli Persone specifiche e aggiungi gli indirizzi uno alla volta. Ogni persona riceve il link via email, e aprirlo significa accedere con quell’indirizzo, così chiunque altro entri in possesso del link resta fuori. In questa modalità non c’è password, perché l’accesso è già il controllo più forte.

Dato che quei lettori hanno effettuato l’accesso, la scheda Visualizzazioni può dire chi di loro ha aperto il documento, quante volte e quando l’ultima, o che qualcuno non l’ha ancora aperto — e la pagina che leggono li avvisa che tu puoi vederlo. I documenti che altri indirizzano a te compaiono nella tua cronologia sotto Condivisi con me, con chi ha condiviso ciascuno.

Rendi privato chiude il link

Riportare un documento su Privato cancella il suo token. L’indirizzo che hai inviato smette di funzionare per tutti, la scadenza e il conteggio delle aperture se ne vanno con lui, e condividere di nuovo crea un link diverso: quello vecchio non torna mai. Poiché non si può annullare, è l’unica modifica che la finestra ti chiede di confermare.

La revoca riguarda l’indirizzo, non le copie: quello che un lettore ha scaricato o stampato resta suo. Una pagina pubblica può restare nella cache edge fino a un minuto, quindi un link revocato può metterci tanto a smettere ovunque; una pagina protetta da password, o condivisa con persone specifiche, non finisce mai in cache.

Cartelle intere, e testo nuovo allo stesso indirizzo

Una cartella si condivide allo stesso modo, da Condividi nel suo menu: le stesse tre modalità, la stessa scadenza e la stessa password, a un indirizzo sotto `/f/`. Chi la apre riceve l’intero albero, ogni pagina si apre al suo interno, e i link tra le pagine restano dentro la cartella condivisa. Un lettore autenticato può premere Salva nel mio account e tenersi una copia di tutto — una copia, quindi quello che cambi dopo non la raggiunge.

Un documento può anche ricevere testo nuovo senza cambiare indirizzo. Pubblicare sul posto — `PUT /api/v1/documents/:id` da uno script, `tp push --update` da un terminale, il plugin per Obsidian o un assistente — sostituisce il testo e mantiene il link, la password, la scadenza e i lettori indicati. Il testo sostituito resta come revisione, le dieci più recenti.