Els editors

L'editor és on passes el temps a Caliu, així que és el que rep més cura. Cada app té el seu propi editor, construït sobre la tecnologia de text de la seva plataforma, i tots comparteixen una promesa: el que es desa és Markdown pla, i el que veus és aquest mateix Markdown, amb format al seu lloc mentre escrius.

Un cicle, tres editors

Tots els editors de Caliu fan les mateixes tres coses:

  1. Llegir el Markdown de la nota i deduir-ne l'estructura: encapçalaments, llistes, tasques, citacions, codi, taules.
  2. Mostrar aquesta estructura com a text amb format, amagant la sintaxi fins que la necessites.
  3. Escriure els teus canvis de tornada com a Markdown, el mateix text pla que pot llegir qualsevol altra app de Markdown.

Obrir una nota no la modifica mai. Una nota només canvia quan l'edites, així que llegir-la en un altre dispositiu no la reescriu mai d'amagat.

A la web: ProseMirror

L'editor web està construït amb Tiptap, que funciona sobre ProseMirror, un conjunt d'eines per editar text enriquit al navegador que fan servir moltes eines d'escriptura conegudes. Els blocs de codi s'acoloreixen amb Shiki, el mateix ressaltador que fan servir molts editors de codi.

A l'iPhone, l'iPad i el Mac: el sistema de text d'Apple

L'editor d'Apple està construït directament sobre la vista de text nativa d'Apple (UITextView a l'iPhone i l'iPad, NSTextView al Mac) i TextKit, el motor de text que hi ha darrere de les apps de la mateixa Apple. El Markdown es llegeix amb la biblioteca swift-markdown d'Apple, que segueix la mateixa especificació que fa servir GitHub, i s'escriu de tornada respectant les teves tries originals: si vas escriure *italic* en lloc de _italic_, es queda així.

Tota la nota és una única vista de text contínua. Això és el que fa que seleccionar, desplaçar-se i editar entre paràgrafs resulti natural. El que no és text pla, com les taules i els blocs de codi, es dibuixa com a vistes pròpies superposades al text.

A Android: el camp de text de la plataforma

L'editor d'Android està construït sobre el camp de text propi d'Android, al qual es dona format mentre escrius. El Markdown es llegeix amb commonmark-java i es comprova amb la mateixa referència que l'app d'Apple. Centenars de documents d'exemple han de sortir de l'editor d'Android exactament com hi van entrar, igual que als dispositius d'Apple.

Per què importa el text natiu

Editar text és una de les coses més difícils de fer bé en una app. Construint sobre el motor de text de cada plataforma en lloc de reinventar-lo, Caliu obté tot el que el teu dispositiu ja sap fer: correcció automàtica i ortogràfica, dictat, mètodes d'entrada per al japonès, el xinès i el coreà, lectors de pantalla com VoiceOver i TalkBack, i les nanses de selecció i les dreceres a què estàs acostumat.

Veure el Markdown

Sempre que vulguis veure el que es desa de debò, canvia al mode de codi font. Mostra el Markdown en brut, amb cada # i cada * inclosos, i també el pots editar allà. Consulta l'article «Mode de codi font».