Rendi i tuoi documenti aziendali pronti per l’AI — in modo affidabile, on‑premise e semanticamente.
È molto comune che le organizzazioni conservino la documentazione in formati PDF, DOCX, XLSX ed ePub. Mentre i LLM (large language model) funzionano bene con HTML o testo semplice, questi formati nativi richiedono una conversione prima di poter essere usati efficacemente in pipeline LLM + RAG dove vogliamo conversare con un documento o un insieme di documenti.
LLM (Large Language Model) — modello AI pre‑addestrato che genera testo e risposte basandosi su grandi corpora di testo.
RAG (Retrieval‑Augmented Generation) — approccio che combina un LLM con una base di conoscenza esterna (ad es. documenti aziendali) così che il modello possa recuperare e ragionare sul contenuto del dominio.
Il diagramma di sequenza seguente illustra i passaggi tipici coinvolti nella generazione di una risposta a una domanda:
La qualità delle risposte che ottieni da un Sistema (LLM + RAG) dipende sia dal Sistema stesso sia da quanto bene i documenti sorgente mantengano la loro struttura e il loro significato quando vengono immessi nel pipeline di recupero.
Il problema
Il formato della documentazione non è solo visuale — trasporta anche semantica. Titoli, elenchi, tabelle, enfasi in grassetto/corsivo, didascalie e immagini in linea trasmettono significato che aiuta un LLM a comprendere il contesto. La semplice conversione dei documenti (ad es. con OCR che tratta ogni pagina come un’immagine piatta) spesso perde queste semantiche. Di conseguenza, il recupero RAG e le risposte del LLM possono diventare inaccurate o rumorose.
L’OCR può aiutare per i documenti scansionati ma spesso rimuove la struttura (elenchi divisi su più pagine, bordi delle tabelle mal interpretati, annotazioni perse). Inoltre aggiunge costi e sovraccarico infrastrutturale quando si elaborano grandi archivi.
La soluzione
Un approccio alternativo è analizzare i documenti con consapevolezza strutturale ed esportare tale struttura in un formato semantico, amico dei LLM — Markdown. Il Markdown è leggero, ampiamente supportato e conserva titoli, elenchi, tabelle, blocchi di codice, enfasi, didascalie e riferimenti alle immagini — esattamente le caratteristiche che migliorano la qualità del recupero.
GroupDocs.Markdown for .NET converte i formati di documento più diffusi (PDF, DOCX, XLSX, ePub e molti altri) in Markdown pulito e semantico, adatto all’ingestione nei sistemi RAG. È una libreria .NET on‑premise, quindi tutta l’elaborazione avviene nel tuo ambiente — nessun servizio esterno, nessuna perdita di dati e nessuna dipendenza da GPU remote.
Come iniziare
GroupDocs.Markdown for .NET è disponibile come pacchetto NuGet, nonché come download MSI e ZIP.
Installa il pacchetto NuGet con la CLI .NET:
dotnet add package GroupDocs.Markdown
Oppure scarica installer e assembly dalla pagina ufficiale dei download: https://releases.groupdocs.com/markdown/net/
Esempio di utilizzo (da aggiungere a Program.cs):
// Import the namespace
using GroupDocs.Markdown;
// Set the license (optional for evaluation)
License.Set("GroupDocs.Markdown.lic");
// Instantiate the converter for a source document
var converter = new MarkdownConverter("rich-text-formatting.docx");
// Convert and save output to file
converter.Convert("rich-text-formatting.md");
Il file rich-text-formatting.md convertito verrà salvato nella stessa cartella della tua applicazione.
Lo screenshot seguente mostra il file DOCX di input e il Markdown di output.
Se esegui senza licenza, la modalità di valutazione elaborerà un numero limitato di pagine (ad es. le prime tre). Per provare la versione completa, richiedi una licenza temporanea.
Per richiedere una licenza temporanea, apri il Purchase Wizard (https://purchase.groupdocs.com/buy/cart?ppId=115659&utm_source=blog), fornisci i dati di contatto e fai clic su Get a temporary license nella fase Contact Details. La licenza temporanea ti sarà inviata via email.
Maggiori informazioni sulle licenze temporanee: https://purchase.groupdocs.com/temporary-license/
Formati di file supportati
GroupDocs.Markdown for .NET supporta una vasta gamma di formati aziendali e di ebook. L’elenco completo delle estensioni supportate:
- PDF
pdf
- Fogli di calcolo
.xls,.xlsx,.xlsb,.xlsm,.xlt,.xltx,.xltm,.xlam,.csv,.tsv,.ods,.ots,.fods,.numbers,.sxc
- Word / Rich Text
.doc,.docx,.dot,.dotm,.dotx,.docm,.rtf,.odt,.ott
- Ebook
.azw3,.mobi,.epub
- Testo / Markup / Help
.chm,.xml,.txt
Come funziona (interni — vista d’insieme)
Quando un documento viene elaborato, avvengono due fasi principali:
-
Estrazione del modello del documento
Il documento viene analizzato in un modello di oggetti in‑memoria che rappresenta gli elementi strutturali (paragrafi, titoli, elenchi, tabelle, immagini, note a piè di pagina, annotazioni, ecc.). Il parser tenta di preservare la semantica (ad es. nidificazione degli elenchi, celle di tabelle, didascalie delle immagini). -
Generazione del Markdown
Il modello viene attraversato e convertito in Markdown secondo le opzioni di conversione configurabili (come gestire le immagini, la formattazione delle tabelle, i livelli dei titoli, le annotazioni speciali, ecc.). Il risultato è un file Markdown leggibile e semanticamente significativo, pronto per l’indicizzazione da parte della tua pipeline RAG.
Esempio di esportazione
Il codice di esempio sopra mostra come esportare un DOCX in Markdown. Vediamo i file sorgente e di output come dimostrazione.
DOCX di origine
Il file sorgente rich-text-formatting.docx contiene vari blocchi di contenuto ed è pesantemente formattato per evidenziare gli elementi semantici principali.
Preview powered by GroupDocs.Viewer for .NET UI.
Markdown di output
Il contenuto generato di rich-text-formatting.md è mostrato qui sotto, per vedere come gli elementi di formattazione vengano rappresentati nel file Markdown.
This document contains a variety of formatted elements that are used to test document rendering quality during file conversion
# <a name="_toc76372684"></a>**Font Formatting**
Source Sans Pro Light, 14 pt.
Simple text in Times New Roman 12 followed by an empty paragraph<sub>subscript</sub> and<sup>superscript</sup>.
Various characters: ‘ “ & < > £ ¥ § ¨ © ª « ® » ¼
Paragraph with multiple segments of text formatted in different fonts, sizes and colors. Very different sizes and colors including **bold**, *italic*, underline and 1 2 3 4 5 ~~strikethrough~~. Make sure that the lines wrapped in the same way in Word and in Pdf.
This text has shading and highlighting and borders, and it is supported.
# <a name="_toc76372685"></a>**Paragraph Formatting**
Paragraph shading should not form empty gaps even with spacing 12 after.
Centered paragraph with a line break had a problem.\
Centered paragraph with a line break had a problem.
Right aligned paragraphs must be right aligned properly.
Right aligned paragraph with line break works well.\
Right aligned paragraph with line break works well.
This paragraph has a border.
Right aligned condensed text had a problem.
Right aligned expanded text had a problem.
Spacing after and before do not add up, just the greater is used. This paragraph has 12 after. Also, when indents are different, the shading does not join.
This paragraph has 12 before, but in total there is only 12 above. Also note that shading belongs to the paragraph at the top and shading of this paragraph does not go down unless next paragraph has shading too. There are 24 points below.
There are 24 points above, but the gap between this and previous paragraph is only 24.
This paragraph is a test for double line spacing. This paragraph is a test for double line spacing. It also have 0.5” for the first line.
This is a test for 1.5 line spacing. This is a test for 1.5 line spacing. Also has -0.5” indent for the first line.
This paragraph has a page break
and centered. It actually creates two paragraphs.
This is a test for Exactly 20 points of spacing. This is a test for Exactly 20 points of spacing. TTTTTT (20, 22, 24, 26, 28, 30).
There is a continuous section break after this line.
This line is in the new section. Next here is an empty section.
This line is in the fourth section.
# <a name="_toc76372686"></a>**Paragraph Justify**
This is a justified paragraph with a single segment. 111111111111111111111111111111111111111111.
Also a justified **paragraph** reset to left because of multiple segments. 111111111111111111111111111111111111111111.
# **Non-English Characters**
Wingdings: (x, Symbol: WÄ
Russian: Теперь немного по русски.
# <a name="_toc76372687"></a>**Tables**
|Cell 1.1 Left|Cell 1.2 Right|||
| :- | -: | :- | :- |
|Cell 2.1 Centered vertically|Cell 2.2 with background|Cell 2.3 with line break<br>and coloured border.||
|Cell 3.1 Bottom vertically|<p>Cell 3.2</p><p>Centered</p><p>Horizontally</p>|Cell 3.3 No border||
|Left red, blue top, green right and yellow bottom.|
| :- |
|Table with left indent and merged cells.||||
| :- | :- | :- | :- |
|||||
|||||
**Cell padding etc.**
|<p>Cell padding.</p><p>Top: 0.1, bottom 0.2</p><p>Left: 0.5, Right 0.4</p>|Zero padding on all sides, right aligned.|
| :- | -: |
|Outer 1.1|Outer 1.2. There is a nested table here||
| :- | :-: | -: |
|**Nested 1.1**|**Nested 1.2**|
| :- | :- |
|||Outer 1.3|
| :- | :-: | -: |
#
# <a name="_toc76372688"></a>**Lists**
**Numbered list:**
1. Item 1
1. Item 2
1. Item 2.1
1. Item 2.2
1. Item 3
**Bulleted list:**
- Item 1
- Item 2
- Item 2.1
- Item 2.2
- Item 3
#
# <a name="_toc76372689"></a>**Images**
This section starts from a new page.
**Ellipse text**
There is an image in a black border in the top right corner, but it will drop down into the text. There is also a transparent ellipse with text that overlaps the picture.
Inline JPEG in a separate paragraph.
---
## Sommario
GroupDocs.Markdown per .NET ti aiuta a convertire una vasta gamma di formati di documento in Markdown semantico, pronto per i sistemi LLM + RAG. Preserva la struttura e il significato del documento, funziona on‑premise e supporta i formati aziendali più comuni — una scelta pratica per le organizzazioni che devono preparare grandi collezioni di documenti per il consumo AI.
---
## Per saperne di più
- Home prodotto: https://products.groupdocs.com/markdown/net/
- Documentazione: https://docs.groupdocs.com/markdown/net/
- Informazioni sulla licenza: https://about.groupdocs.com/legal/
- Download: https://releases.groupdocs.com/markdown/net/
---
## Supporto e feedback
Per domande o assistenza tecnica, usa il nostro **Forum di Supporto Gratuito** (https://forum.groupdocs.com/) — saremo felici di aiutarti.