Leggi. Verifica. Condividi.

Trasforma il tempo passato tra i documenti in tempo per pensare.

Da README e diagrammi a documenti PDF e Office, KatanA apre, consente di leggere, modificare e condividere i documenti del progetto in un unico workspace desktop.

macOS Windows Linux GitHub
Albero dei file, sorgente Markdown e anteprima mostrati insieme in KatanAAlbero dei file, sorgente Markdown e anteprima mostrati insieme in KatanA
Passa da file a visualizzazione mantenendo il contesto del progetto.

01

Inizia subito dai tuoi documenti.

Non devi spostarli in un nuovo archivio. Apri il progetto locale e scegli come leggerlo in base allo scopo.

Trasforma il repository in uno spazio di lavoro leggibile.

Passa da README, specifiche e materiali di supporto usando albero dei file e schede. La ricerca nel workspace riguarda Markdown e consente filtri per maiuscole, parole intere ed espressioni regolari.

  1. Apri come workspace la cartella che contiene i documenti.
  2. Scegli un documento dall'albero dei file e apri i materiali correlati in un'altra scheda.
  3. Usa la ricerca nel documento o la ricerca Markdown del workspace per raggiungere il punto da verificare.

Puoi confrontare i documenti correlati nello stesso workspace usando la struttura delle cartelle come riferimento.

Albero dei file di KatanA e anteprima del README selezionatoAlbero dei file di KatanA e anteprima del README selezionato

Verifica insieme sorgente e visualizzazione.

Mostra sorgente Markdown e anteprima affiancati per controllare le modifiche al testo e alla sintassi. Regola orientamento, ordine dei pannelli e indice secondo il lavoro da svolgere.

  1. Apri un file .md o .markdown e attiva la visualizzazione divisa tra sorgente e anteprima.
  2. Modifica testo o titoli e verifica come cambiano nell'anteprima.
  3. Controlla il contenuto e salvalo. Se serve, esportalo in HTML, PDF, PNG o JPEG.

Puoi controllare il risultato a schermo prima di salvarlo esplicitamente. Non dare per scontato il salvataggio automatico: salva il documento.

Sorgente Markdown e risultato renderizzato affiancati in KatanASorgente Markdown e risultato renderizzato affiancati in KatanA

Mantieni i diagrammi nello stesso contesto del testo.

Renderizza Mermaid, PlantUML e Draw.io dentro Markdown. Verifica il collegamento con la spiegazione prima di riaprire il diagramma in un altro strumento.

  1. Indica i linguaggi mermaid, plantuml o drawio nei blocchi di codice Markdown.
  2. Prepara PlantUML con @startuml / @enduml e Draw.io come XML non compresso.
  3. Controlla diagramma e testo circostante nell'anteprima ed esporta il documento se necessario.

Puoi revisionare definizione del diagramma e spiegazione insieme. Consulta la guida ai formati per sintassi e condizioni di input.

Più diagrammi visualizzati dentro Markdown in KatanAPiù diagrammi visualizzati dentro Markdown in KatanA

02

Formati diversi, un solo workspace.

Non tutti i formati sono modificabili allo stesso modo. Presentiamo separatamente capacità e condizioni di input di ciascun formato.

HTML

Apre i documenti HTML, ne consente la visualizzazione e la modifica della sorgente. Usa un percorso di anteprima HTML distinto da Markdown per controllare e modificare materiali web esistenti.

Le modifiche vengono applicate al file con un'operazione di salvataggio.

Mermaid / PlantUML

Renderizza diagrammi dai blocchi di codice Markdown con mermaid e plantuml, racchiudendo l'input PlantUML tra le direttive di apertura e chiusura.

PlantUML richiede @startuml / @enduml.

Draw.io

Renderizza diagrammi inserendo XML non compresso in un blocco di codice drawio. Controlla il formato di input prima dell'uso.

Richiede XML non compresso che includa <mxfile> o <mxGraphModel>.

03

Tre passaggi per aprire il primo documento.

Inizia dal README del progetto che usi normalmente. Puoi provare il metodo di lettura con i file esistenti.

  1. Ottieni il pacchetto per il tuo sistema operativo.

    Scarica direttamente il file della release pubblicata dai pulsanti macOS, Windows o Linux. Consulta la pagina di installazione per la procedura.

  2. Apri la cartella con i documenti.

    Apri la cartella del progetto come workspace. Se necessario, configura profondità di esplorazione, directory escluse ed estensioni visibili.

  3. Leggi, verifica e condividi.

    Seleziona i documenti dall'albero e procedi con schede, ricerca e visualizzazione divisa. Per esportare Markdown, scegli il formato in base alla destinazione.

04

Cosa sapere prima di iniziare.

Chiariamo sia le funzioni disponibili sia i limiti nella gestione dei file.

Office e PDF sono per la lettura.

I documenti binari supportati sono PDF, DOCX, XLSX e PPTX. Si aprono solo in anteprima, quindi non equivalgono alle funzioni di modifica delle applicazioni Office.

I documenti binari hanno limiti di input.

La dimensione massima è 256 MiB. Vengono verificati MIME e firma del file, oltre all'estensione; i file in cui formato dichiarato e contenuto reale non coincidono non vengono aperti.

Controlla e salva le modifiche.

Il salvataggio Markdown è esplicito. Aggiornamento dell'anteprima e salvataggio su disco sono separati: salva il documento prima di terminare.

Verifica il risultato con materiali reali.

Controlla layout complessi e sintassi dei diagrammi con i file che userai. Puoi segnalare problemi dall'app includendo le condizioni di riproduzione.

Rispondiamo prima alle domande comuni.

È un'applicazione solo per Markdown?

No. Oltre a Markdown supporta HTML, PDF, Word (DOCX), Excel (XLSX) e PowerPoint (PPTX). L'ambito di modifica e lettura varia in base al formato.

Su quali sistemi operativi funziona?

Sono disponibili distribuzioni per macOS, Windows e Linux. Prima dell'installazione verifica il pacchetto e l'ambiente di destinazione.

Qual è la differenza rispetto alle librerie della serie KatanA?

KatanA è un'app desktop pronta all'uso. Le librerie della serie sono componenti per sviluppatori che integrano modelli documentali, rendering o UI nelle proprie applicazioni.

KatanA / Desktop

Fai la prossima revisione con KatanA.

Prova con i tuoi documenti abituali la lettura tramite albero, schede e anteprima.