• 1. Oggetto dell’articolo.
• 2. Analisi del sorgente in Python.
• 3. Il codice sorgente completo in Python.

1. Oggetto dell’articolo.

L’obiettivo è quello di generare un semplice programma che permetta di raccogliere il testo contenuto in vari PDF generati direttamente da programmi di videoscrittura e di inserire i vari frammenti in un unico documento in linguaggio Markdown separando i frammenti con titoli di secondo livello corrispondenti al nome dei documenti di provenienza.

Come se la cavano quattro editor generalisti, ovvero progettati per essere utilizzati con una vasta gamma di linguaggi di programmazione e file di testo, per la scrittura di documenti in linguaggio Markdown? Questo è l’oggetto di questo articolo basato sulle mie esperienze personali nell’utilizzo di Vim, Emacs, Sublime Text 4 e Visual Studio Code sia direttamente che con estensioni dedicate al predetto linguaggio di marcatura.

Premessa

Vim è un ottimo editor per Markdown, sia per le proprie caratteristche “native” che per la possibilità di aggiungere specifiche funzioni tramite “plugin”.

Per la visualizzazione in anteprima dei documenti occorre, a meno che non si utilizzi la soluzione “manuale” menzionata al termine di questo articolo, utilizzare un “plugin” dedicato.

Fino a qualche anno fa, il mio preferito era “iamcco/markdown-preview.vim” perchè forniva un vero effetto live in tempo reale durante la digitazione del testo, ancora prima del salvataggio periodico.

Che senso ha parlare di Org-Mode al posto di Markdown?

Per quale motivo dovrei usare Org-Mode per scrivere gli articoli da pubblicare rete in formato Markdown?

Non sarebbe più comodo scrivere gli articoli direttamente in Markdown?

La domanda è più che giustificata e la risposta non è scontata.

Innanzitutto ricordo che Org-Mode è una modalità di GNU/Emacs. Pur essendovi vari plugin per altri editor, Vim compreso, nessuno di essi riesce ad eguagliare la straordinaria efficienza del sistema originale.

Abstract

Utilizzare Mozilla Firefox come visualizzatore di documenti scritti in Markdown sotto Linux Ubuntu, Fedora and Arch, con menzione di MS Windows e macOS.

Mozilla Firefox ed il formato Markdown

Mozilla Firefox, uno dei migliori navigatori di Internet, non legge nativamente i documenti scritti in Markdown.

Se si prova ad aprire un documento scritto in Markdown il navigatore chiede se debba salvarlo in locale o se debba aprirlo con un’applicazione tra quelle proposte dal sistema operativo. Ma non renderizza il documento.

Obiettivo di questo articolo

L’obiettivo di questo post è quello di ottenere un link correttamente formattato in Markdown unendo in un unico comando un frammento di testo e un indirizzo Internet preventivamente salvato negli appunti di Vim.

Naturalmente presumo che chiunque stia leggendo questo post sappia come creare un collegamento ben formattato in Markdown, cioè testo tra parentesi quadre e URL tra parentesi tonde.

Perché mi sono posto questa domanda?

Le risorse di riferimento: Emacs, Markdown-mode

Questo articolo riguarda le seguenti risorse:

• Emacs: GNU Emacs 26.3 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.22.30) of 2019-12-03
• Markdown Mode: markdown-mode-20200622.20
• OS: Linux Ubuntu 20.4 LTS, Linux Fedora 32

Il problema in poche parole: occorre inserire un collegamento testuale in un documento scritta utilizzato il Markdown-mode for Emacs e nel testo descrittivo del collegamento occorre inserire uno o più spazi.

Questi sono i singoli passaggi: