Per trasformare un file TXT in Markdown spesso basta cambiare l'estensione da .txt a .md. Il Markdown è testo semplice, quindi un file di testo è già un documento Markdown valido.
Il testo semplice non ha titoli, grassetti o tabelle da recuperare, e un convertitore non li inventa. Convertire con MD Factory serve in altri casi: il file è in una vecchia codifica come Windows-1251, i file TXT condividono una cartella con PDF e documenti Word, oppure ogni file di una biblioteca per un agente IA deve avere la stessa forma.
Quando basta rinominare
Rinominare funziona quando il testo è in UTF-8 e nient'altro ha bisogno del file con il suo vecchio nome. La specifica CommonMark del Markdown dice che qualsiasi sequenza di caratteri è un documento valido.
Per vedere la codifica, apri il file nel Blocco note e guarda l'angolo in basso a destra della barra di stato. UTF-8 significa che puoi rinominare il file. Qualsiasi altra cosa, come ANSI o UTF-16, deve prima diventare UTF-8, e le sezioni seguenti spiegano come. ANSI indica una vecchia codifica di Windows, come Windows-1251 per il cirillico o Windows-1252 per le lingue dell'Europa occidentale.
Per rinominare un file, attiva le estensioni dei nomi file in Esplora file: Visualizza, poi Mostra, poi Estensioni nomi file. Poi cambia la fine del nome da .txt a .md e conferma quando Windows chiede di cambiare l'estensione. Come osserva Microsoft, una nuova estensione cambia solo il nome, non il contenuto.
Per molti file, apri PowerShell nella loro cartella. Questo comando si limita a elencare ciò che rinominerebbe:
Get-ChildItem -Filter *.txt | Rename-Item -NewName { $_.BaseName + '.md' } -WhatIfSe l'elenco è giusto, esegui lo stesso comando senza l'ultima parte:
Get-ChildItem -Filter *.txt | Rename-Item -NewName { $_.BaseName + '.md' }Per includere le sottocartelle, usa gli stessi due comandi con un parametro in più:
Get-ChildItem -Filter *.txt -Recurse | Rename-Item -NewName { $_.BaseName + '.md' } -WhatIf
Get-ChildItem -Filter *.txt -Recurse | Rename-Item -NewName { $_.BaseName + '.md' }Se un altro programma apre questi file con i vecchi nomi, copiali prima di rinominarli.
Quando conviene convertire
| Situazione | Dopo aver rinominato | Dopo la conversione con MD Factory |
|---|---|---|
| Il testo è in Windows-1251 o in un'altra vecchia codifica | Il testo resta in quella codifica; un'app che legge il file come UTF-8 mostra caratteri illeggibili | Il testo viene salvato in UTF-8, e il file è contrassegnato come Da controllare per permetterti di verificarlo |
| I file TXT condividono una cartella con PDF, documenti Word e altri | Cambiano solo i file TXT; gli altri documenti richiedono un altro strumento | Un solo passaggio sulla cartella e le sue sottocartelle; ogni documento riceve un file Markdown accanto a sé |
| I file originali devono restare come sono | Il file TXT diventa il file Markdown | Il file TXT resta invariato, e il file Markdown compare accanto a esso |
| Uno script o un agente IA ha bisogno che ogni file abbia la stessa forma | Ogni file mantiene la propria codifica e i propri fine riga | Ogni file Markdown ha la stessa codifica e gli stessi fine riga |
Per una cartella con molti formati, consulta come convertire in blocco i documenti in Markdown. Per organizzare il risultato per un agente IA, consulta come preparare i documenti per gli agenti IA.
Cosa fa MD Factory con un file TXT
Aggiungi i file TXT o la loro cartella con Aggiungi file o Aggiungi cartella, oppure trascinali nella finestra. La conversione parte subito, e ogni file Markdown viene salvato accanto al suo file TXT. MD Factory copia il testo così com'è: non aggiunge titoli né elenchi e non riscrive nulla.
- Il testo in UTF-8, o con un indicatore dell'ordine dei byte, viene letto così com'è. Il file riceve lo stato Completato.
- Il testo in una codifica più vecchia viene riconosciuto dal contenuto e salvato in UTF-8. Un file del genere riceve sempre Da controllare, con il messaggio «È stata dedotta la codifica del testo. Controlla i caratteri speciali.»
- Se la codifica non si riesce a determinare, il file fallisce con il messaggio «La codifica del testo non può essere letta in modo affidabile.»
- Il file Markdown è sempre UTF-8 senza indicatore dell'ordine dei byte, con fine riga LF.
- I caratteri che il Markdown legge come formattazione restano come sono. Una riga che inizia con # e uno spazio diventa un titolo in un visualizzatore Markdown, e una parola tra asterischi diventa corsivo.
- Vengono convertiti solo i file che terminano in .txt. File come .log o .ini risultano saltati; rinominali in .txt per convertirli, oppure direttamente in .md.
- Un file TXT più grande di 64 MB fallisce con il messaggio «Questo documento supera gli attuali limiti di elaborazione.» Dividilo in file più piccoli, oppure rinominalo.
Controllare i file con codifica ipotizzata
Apri ogni file contrassegnato come Da controllare e guarda i caratteri al di fuori dell'alfabeto inglese: lettere cirilliche, lettere accentate, virgolette e trattini tipografici.
Il testo cirillico in Windows-1251, KOI8-R o DOS 866 viene di solito riconosciuto correttamente se il file contiene almeno una frase.
Il testo dell'Europa occidentale in Windows-1252 è il punto debole. MD Factory spesso lo scambia per Windows-1250 dell'Europa centrale, e alcune lettere cambiano: è diventa č, ñ diventa ń, ã diventa ă.
Se tali caratteri sono rari in un file, ad esempio pochi nomi con accenti o virgolette tipografiche in un testo inglese, si trasformano nel segno �.
Il file TXT in sé non viene modificato, quindi puoi correggerlo e convertirlo di nuovo. Salva il file solo quando il testo appare giusto: salvare in UTF-8 un testo illeggibile rende il danno permanente. Se il file è importante, lavora su una copia.
- Apri il file TXT nel Blocco note. Se il testo appare giusto, scegli File, poi Salva con nome, imposta Codifica su UTF-8 e salva.
- Se il testo appare sbagliato anche nel Blocco note, apri il file in Visual Studio Code. Fai clic sulla codifica nella barra di stato, scegli Reopen with Encoding e seleziona quella giusta, ad esempio Western (Windows 1252). Poi fai di nuovo clic sulla codifica e salva il file in UTF-8.
- In MD Factory, cancella l'elenco e aggiungi di nuovo il file. Oppure rinominalo semplicemente in .md: in UTF-8 non ha più bisogno di conversione.
MD Factory sostituisce il suo risultato precedente se non l'hai modificato. Se l'hai modificato, il nuovo risultato viene salvato con un numero, ad esempio notes (2).md.
Aggiungere titoli ed elenchi a mano
Il testo semplice non dice quale riga sia un titolo, quindi la struttura spetta a te. Apri il file Markdown in qualsiasi editor di testo e scrivi questi segni all'inizio di una riga:
| Per ottenere | Inizia la riga con |
|---|---|
| Un titolo | # e uno spazio; ## per un sottotitolo, ### per il livello inferiore |
| Una voce di elenco puntato | - e uno spazio |
| Una voce di elenco numerato | 1. e uno spazio |
| Un nuovo paragrafo | Una riga vuota prima |
Un singolo a capo all'interno di un paragrafo può comparire come uno spazio: la specifica CommonMark ammette entrambi i comportamenti. Dove gli a capo contano, come negli indirizzi o nelle poesie, termina ogni riga con una barra rovesciata oppure metti una riga vuota tra le righe.
Per impedire che un carattere si trasformi in formattazione, mettigli davanti una barra rovesciata: \# all'inizio di una riga mostra un semplice #. La guida di GitHub alla sintassi di base per scrivere e formattare elenca gli altri segni.
Un agente IA può aggiungere la struttura per te. Chiedigli di mantenere le parole e di scrivere in un nuovo file:
Aggiungi titoli ed elenchi Markdown a notes.md.
Non cambiare, aggiungere o rimuovere nessuna parola.
Salva il risultato come notes-formatted.md e lascia notes.md invariato.Confronta i due file prima di tenere quello nuovo. Per vedere il risultato con la sua formattazione, leggi come aprire un file MD su Windows.