Editor

La superficie delle note dell’app web ha un unico interruttore Reading view / Edit in cima alla nota. La vista di lettura è dove avviene il rendering ricco; Edit è un semplice campo di testo CodeMirror 6 per scrivere markdown.

Vista di lettura (rendering)

Il visualizzatore è uno stack remark/rehype progettato per la compatibilità con Obsidian. Se si visualizza in Obsidian, dovrebbe visualizzarsi anche qui.

• CommonMark + GFM: titoli, elenchi, tabelle, blocchi di codice delimitati, testo barrato, elenchi di attività
• Wikilink: [[Note Title]] e [[Note Title|Display Text]], resi come link a /notes/<path>
• Immagini incorporate: ![[image.png]] si risolve tramite l’API autenticata degli allegati
• Callout: > [!note], > [!warning], > [!tip] e simili in stile Obsidian, tramite @portaljs/remark-callouts
• Formule KaTeX: $inline$ e $$display$$
• Diagrammi Mermaid: blocchi delimitati ```mermaid
• Evidenziazione della sintassi: blocchi di codice delimitati resi con rehype-highlight
• Frontmatter: il YAML in cima al file viene interpretato con gray-matter; il corpo viene mostrato sotto
• Titoli con link automatico: ogni titolo riceve uno slug e un link di ancoraggio

Modalità di modifica (scrittura)

La modalità di modifica inserisce un campo CodeMirror 6 con il plugin del linguaggio markdown (evidenziazione della sintassi), a capo automatico e un carattere da 16px adatto al mobile che evita lo zoom automatico di iOS Safari.

Non c’è un pulsante Salva. L’editor salva automaticamente mentre scrivi: un indicatore di stato in cima alla nota mostra Saving… mentre una scrittura è in corso, Saved quando è completata e Save failed con un link Retry cliccabile se una scrittura va in errore.

L’editor web è volutamente una superficie di acquisizione rapida: apri una nota, modifica, vai via. Per una scrittura più ricca (menu con barra, trova/sostituisci nell’editor, completamento automatico di wikilink e tag), lo strumento giusto è Obsidian. La divisione è voluta, non una mancanza; Obsidian è già un editor eccezionale e ci sincronizziamo nativamente, quindi l’app web si concentra su ciò che è difficile da fare bene da Obsidian (consultazione fra più archivi, accesso da mobile senza l’app Obsidian per iOS, accesso da qualsiasi browser).

Modifica sicura in caso di conflitti

L’editor web passa per lo stesso motore di sincronizzazione del plugin. Se un altro dispositivo modifica la stessa nota mentre l’hai aperta, l’editor reagisce senza perdere il tuo lavoro:

• Le modifiche remote in arrivo vengono integrate nella tua bozza aperta con un’unione a 3 vie. Le unioni pulite avvengono in silenzio.
• Se il tuo salvataggio è in competizione con la scrittura di un altro dispositivo, il backend restituisce un 409. L’editor recupera l’ultima versione, ricostruisce la tua modifica sopra di essa con un’unione a 3 vie e riprova automaticamente il salvataggio.
• Quando un’unione ha una vera sovrapposizione a livello di riga, la tua bozza resta esattamente com’è e compare una ConflictBar non bloccante con tre scelte: Keep mine, Take theirs o View merge. Nulla viene scartato in silenzio.

I plugin di Obsidian non sono supportati

Tutto ciò che dipende da un plugin della community di Obsidian (query Dataview, output di Templater, estensioni canvas personalizzate, forme di Excalidraw e così via) non verrà eseguito nell’editor web. L’app web ha un proprio renderer; non può eseguire il codice dei plugin della tua installazione di Obsidian. I blocchi Dataview vengono mostrati come semplice codice delimitato, la sintassi di Templater resta non risolta, e così via.

Le note che dipendono dal rendering dei plugin sono comunque al sicuro. Si sincronizzano come markdown semplice e appaiono corrette in Obsidian. Semplicemente non ottengono il rendering dinamico quando vengono viste nell’app web.

La compatibilità con i plugin è qualcosa che potremmo esplorare in una futura versione maggiore, ma non è nella roadmap attuale.

Mobile

L’editor è adatto al tocco ma limitato dallo schermo piccolo. Per modifiche impegnative sul telefono, Obsidian mobile è di solito la superficie migliore. Le modifiche rapide e la ricerca nell’app web funzionano bene.