Per salvare una pagina web come Markdown, salvala in Chrome o Edge con Ctrl+S come Pagina web, completa, poi aggiungi il file HTML a MD Factory. L'app converte la pagina sul tuo PC e salva un file Markdown con le immagini della pagina accanto.
Questa guida è per le pagine che conservi per te: articoli, documentazione, ricette, pagine di riferimento. Se devi convertire HTML in uno script o in una build, passa all'ultima sezione.
Salvare la pagina in Chrome o Edge
In Chrome, premi Ctrl+S oppure apri il menu Altro, scegli Trasmetti, salva e condividi, poi Salva pagina con nome. I passaggi sono descritti in Guida di Chrome.
In Edge, premi Ctrl+S. La scorciatoia è elencata in Scorciatoie da tastiera di Edge.
Nell'elenco Salva come, scegli Pagina web, completa. Entrambi i browser offrono tre formati, e MD Factory li tratta in modo diverso:
| Salva come | Cosa salva il browser | Cosa ottieni in MD Factory |
|---|---|---|
| Pagina web, completa | Un file HTML e una cartella con lo stesso nome che termina in _files, che contiene le immagini | Testo e immagini |
| Pagina web, solo HTML | Solo il file HTML; le immagini restano sul sito web | Testo senza immagini, contrassegnato come Da controllare |
| Pagina web, file singolo | Un unico file MHTML | Niente: MD Factory non apre i file MHTML e li indica come saltati |
Convertire la pagina salvata
- Apri MD Factory.
- Fai clic su Aggiungi file e scegli il file HTML salvato, oppure trascinalo nella finestra.
- La conversione parte subito. Quando la riga mostra il risultato, fai doppio clic sul percorso del risultato per aprire il file Markdown.
Aggiungi il file HTML, non la cartella in cui si trova. Se aggiungi la cartella, MD Factory esamina anche la cartella _files: i suoi script, fogli di stile e immagini risultano saltati, e gli eventuali file HTML al suo interno vengono convertiti come note separate.
Il file Markdown prende il nome della pagina e viene salvato accanto a essa. Le immagini che usa vanno in una cartella lì accanto:
Saved pages/
Sourdough bread.html
Sourdough bread_files/
Sourdough bread.md
Sourdough bread_images/La pagina salvata e la sua cartella _files restano come prima. Se sposti il file Markdown, sposta con lui la cartella _images: il Markdown rimanda alle immagini in quella cartella.
Cosa passa nel Markdown
| Nella pagina | Nel Markdown |
|---|---|
| Titoli | Titoli dello stesso livello |
| Paragrafi, elenchi e citazioni | Conservati, con il testo in grassetto e in corsivo |
| Blocchi di codice e codice inline | Conservati come codice |
| Tabelle | Tabelle Markdown |
| Immagini salvate con la pagina | Copiate nella cartella delle immagini come file PNG |
| Link | Conservati, come descritto più avanti |
| Script, stili e frame incorporati, come i lettori video di altri siti | Rimossi |
| Menu del sito, intestazioni, piè di pagina, barre laterali e avvisi sui cookie | Conservati come normale testo e link |
| Il titolo nella scheda del browser | Non incluso |
Se una tabella ha celle di intestazione, la sua prima riga diventa l'intestazione della tabella Markdown. Altrimenti l'app aggiunge intestazioni di colonna numerate. Le celle unite vengono distribuite sulla griglia: il valore resta nella prima cella, e le celle che copriva restano vuote.
Quali immagini vengono conservate
MD Factory non scarica mai nulla da internet. Un'immagine arriva nel Markdown solo se il suo file è sul tuo PC:
- le immagini nella cartella _files creata da Pagina web, completa;
- le immagini in altre cartelle intorno alla pagina, comprese quelle sopra di essa;
- le immagini incorporate nel codice HTML stesso.
Un'immagine che esiste solo sul sito web viene omessa, e il file viene contrassegnato come Da controllare. Anche le immagini SVG non sono supportate e vengono omesse.
Come vengono gestiti i link
- Gli indirizzi web completi, i link e-mail e i link telefonici restano esattamente come sono.
- I link relativi, come un link a un'altra pagina dello stesso sito, diventano indirizzi web completi se la pagina salvata registra il proprio indirizzo originale. Altrimenti restano come scritti e funzionano solo se il file collegato si trova nella stessa posizione rispetto al file Markdown.
- I link a una sezione della stessa pagina continuano a funzionare, perché le sezioni mantengono i loro ancoraggi nel Markdown.
- I link che eseguono uno script al clic, quelli che iniziano con javascript:, diventano testo semplice.
Ripulire la nota
MD Factory converte tutto il corpo della pagina. Non prova a indovinare quale parte sia l'articolo, quindi aspettati il menu del sito in alto e il piè di pagina, i link correlati e l'avviso sui cookie in fondo. Elimina ciò che non ti serve.
Il titolo della scheda del browser non è incluso. Se manca il titolo dell'articolo stesso, aggiungine uno in cima.
Aggiungi l'indirizzo della pagina e la data in cui l'hai salvata come prima riga della nota. Così potrai ritrovare l'originale e citarlo quando lo riporti.
Se tieni le note in Obsidian, la nostra guida all'importazione dei documenti in Obsidian spiega come convertire i file in un vault e mantenere collegate le loro immagini.
Se la pagina risulta Da controllare
Da controllare significa che il file Markdown è stato salvato, ma qualcosa della pagina non è passato. Quando la coda è terminata, fai clic sullo stato nella riga del file per leggere il messaggio.
| Messaggio | Causa abituale |
|---|---|
| Un'immagine o una risorsa esterna è stata saltata. | Un'immagine si trova solo sul sito web, ad esempio dopo aver salvato come Pagina web, solo HTML. |
| Non è stato possibile esportare un'immagine. | La pagina rimanda a un file immagine che manca nella cartella. |
| Un formato immagine non è supportato. | L'immagine è in un formato che l'app non può convertire, come SVG. |
| Alcuni contenuti del documento non possono essere rappresentati in Markdown. | La pagina aveva un frame incorporato, come un lettore video di un altro sito, ed è stato rimosso. |
| Non è stato possibile preservare una destinazione di collegamento locale. | Un link a un'altra pagina del sito non ha trovato corrispondenza con un indirizzo web o un file salvato. Il suo testo viene conservato senza il link. |
| È stata dedotta la codifica del testo. Controlla i caratteri speciali. | La pagina non è salvata in UTF-8, quindi l'app ha dovuto ricavarne la codifica. Controlla le lettere accentate e i simboli. |
Convertire HTML nel codice
Se ti serve HTML in Markdown in uno script, in una build o in uno scraper, MD Factory è lo strumento sbagliato: funziona tramite la sua finestra, senza riga di comando né interfaccia di programmazione. Usa invece una libreria. Turndown converte HTML in Markdown in JavaScript, in Node.js o nel browser, con licenza MIT. html2text fa lo stesso in Python, con licenza GPL-3.0. Pandoc è un convertitore da riga di comando tra molti formati di documento, tra cui HTML e Markdown. Con qualsiasi di questi, le regole di conversione e la gestione di immagini e link sono a tuo carico.
pandoc -f html -t gfm page.html -o page.md