Scrivere in modo sostenibile usando il testo semplice con Pandoc e Markdown/Filosofia

Scrivere, archiviare e recuperare documenti sono attività centrali nel flusso di lavoro della ricerca umanistica. Eppure, molti autori basano la loro pratica su strumenti e formati proprietari che a volte non soddisfano nemmeno i requisiti di base della scrittura accademica. Forse puoi rimanere frustrato dalla fragilità di note a piè di pagina, bibliografie, immagini e bozze di libri scritti in Microsoft Word o Google Documenti. Ciò nonostante, la maggior parte delle riviste continua ad accettare testi in formato .docx.

Più che causare frustrazione personale, questa dipendenza da strumenti e formati proprietari ha implicazioni negative a lungo termine per la comunità accademica. In tale ambiente le riviste devono esternalizzare la composizione, allontanare gli autori dai contesti materiali della pubblicazione e aggiungere ulteriori ostacoli inutili alla libera circolazione della conoscenza.

Quando utilizzi MS Word, Google Documenti, OpenOffice o Libreoffice per scrivere documenti, ciò che vedi non è ciò che ottieni. Sotto lo strato visibile di parole, frasi e paragrafi si trova un livello complicato di codice comprensibile solo alle macchine. A causa di tale livello nascosto, per essere visualizzati correttamente i file .docx e .pdf dipendono da strumenti proprietari. Tali documenti sono difficili da cercare, stampare e convertire in file di altro formato.

Inoltre, il tempo impiegato per la formattazione del documento in MS Word o OpenOffice è sprecato, poiché tutta la formattazione viene rimossa dall'editore a cui viene inviato. Sia gli autori che gli editori trarrebbero vantaggio dallo scambio di file con una formattazione minima, lasciando la composizione alla fase finale del processo di pubblicazione.

Questo è il passaggio dove Markdown si mette in luce. Markdown è una sintassi per marcare gli elementi semantici all'interno di un documento in modo esplicito, non in un livello nascosto. L'idea è di identificare le unità che sono significative per gli esseri umani, come titoli, sezioni, sottosezioni, note a piè di pagina e illustrazioni. Per lo meno, i tuoi file rimarranno sempre comprensibili per te, anche se l'editor che stai attualmente utilizzando smette di funzionare o "chiude".

Scrivere in questo modo libera l'autore dallo strumento. Markdown può essere scritto in qualsiasi editor di testo e offre un ricco ecosistema di software in grado di trasformare quel testo in bellissimi documenti. Per questo motivo, Markdown sta attualmente godendo di un periodo di crescita, non solo come mezzo per scrivere articoli accademici, ma come convenzione per l'editing online in generale.

I più popolari editor di testo semplice includono TextWrangler e Sublime per Mac, Notepad++ per Windows, oltre a Gedit e Kate per Linux. Tuttavia, ci sono anche editor specializzati nella visualizzazione e modifica di Markdown.

È importante capire che Markdown è semplicemente una convenzione. I file Markdown vengono archiviati come testo semplice, aggiungendo ulteriore flessibilità al formato. I file di testo semplice sono in circolazione dall'epoca della macchina da scrivere elettronica. La longevità di questo standard rende intrinsecamente il testo semplice più sostenibile e stabile rispetto ai formati proprietari. Mentre i file prodotti anche dieci anni fa in Microsoft Word e le pagine di Apple possono causare problemi significativi quando vengono aperti con la versione più recente, è ancora possibile aprire un file scritto da qualsiasi editor di testo semplice "morto" magari da alcuni decenni: AlphaPlus, Perfect Writer, Text Wizard, Spellbinder, WordStar, o lo SCRIPSIT 2.0 preferito da Isaac Asimov, prodotto da Radio Shack. La scrittura in testo semplice garantisce che i tuoi file rimarranno leggibili tra dieci, quindici, venti anni. In questo tutorial, delineiamo un flusso di lavoro che libera il ricercatore dal programma di elaborazione testi proprietario e dai formati di file fragili.

Ora è possibile scrivere una vasta gamma di documenti in un unico formato: articoli, post di blog, wiki, programmi e lettere di raccomandazione, utilizzando lo stesso insieme di strumenti e tecniche per cercare, scoprire, eseguire il backup e distribuire i nostri materiali. Le note, i post di blog, la documentazione del codice e i wiki possono essere tutti creati in Markdown. Sempre più piattaforme come WordPress, Reddit e GitHub supportano in modo nativo la scrittura in Markdown. A lungo termine, la tua ricerca trarrà vantaggio da tali flussi di lavoro unificati, rendendo più semplice il salvataggio, la ricerca, la condivisione e l'organizzazione dei tuoi materiali.