Salvataggio di documenti come Markdown in Aspose.Words per Java

Introduzione al salvataggio dei documenti come Markdown in Aspose.Words per Java

In questa guida passo passo, dimostreremo come salvare i documenti come Markdown utilizzando Aspose.Words per Java. Markdown è un linguaggio di markup leggero comunemente utilizzato per la formattazione di documenti di testo. Con Aspose.Words per Java, puoi convertire facilmente i tuoi documenti Word in formato Markdown. Tratteremo diversi aspetti del salvataggio dei file Markdown, incluso l’allineamento del contenuto della tabella e la gestione delle immagini.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti prerequisiti:

• Java Development Kit (JDK) installato sul tuo sistema.
• Aspose.Words per la libreria Java. Puoi scaricarlo daQui.

Passaggio 1: creazione di un documento Word

Iniziamo creando un documento Word che successivamente convertiremo nel formato Markdown. Puoi personalizzare questo documento secondo le tue esigenze.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserisci una tabella con due celle
builder.insertCell();
builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
builder.write("Cell1");

builder.insertCell();
builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
builder.write("Cell2");

// Salva il documento come Markdown
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
doc.save("output.md", saveOptions);

In questo esempio creiamo una semplice tabella con due celle e impostiamo l’allineamento dei paragrafi all’interno di queste celle. Quindi, salviamo il documento come Markdown utilizzando il fileMarkdownSaveOptions.

Passaggio 2: personalizzare l’allineamento del contenuto della tabella

Aspose.Words per Java ti consente di personalizzare l’allineamento del contenuto della tabella durante il salvataggio come Markdown. Puoi allineare il contenuto della tabella a sinistra, a destra, al centro o lasciare che venga determinato automaticamente in base al primo paragrafo in ciascuna colonna della tabella.

Ecco come personalizzare l’allineamento del contenuto della tabella:

// Imposta l'allineamento del contenuto della tabella a sinistra
saveOptions.setTableContentAlignment(TableContentAlignment.LEFT);
doc.save("left_alignment.md", saveOptions);

// Imposta l'allineamento del contenuto della tabella a destra
saveOptions.setTableContentAlignment(TableContentAlignment.RIGHT);
doc.save("right_alignment.md", saveOptions);

// Imposta l'allineamento del contenuto della tabella al centro
saveOptions.setTableContentAlignment(TableContentAlignment.CENTER);
doc.save("center_alignment.md", saveOptions);

//Imposta l'allineamento del contenuto della tabella su automatico (determinato dal primo paragrafo)
saveOptions.setTableContentAlignment(TableContentAlignment.AUTO);
doc.save("auto_alignment.md", saveOptions);

Modificando ilTableContentAlignment proprietà, puoi controllare il modo in cui viene allineato il contenuto all’interno delle tabelle durante la conversione in Markdown.

Passaggio 3: gestione delle immagini

Per includere immagini nel tuo documento Markdown, devi specificare la cartella in cui si trovano le immagini. Aspose.Words per Java ti consente di impostare la cartella delle immagini nel fileMarkdownSaveOptions.

Ecco come impostare la cartella delle immagini e salvare il documento con le immagini:

// Caricare un documento contenente immagini
Document doc = new Document("document_with_images.docx");

// Imposta il percorso della cartella delle immagini
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
saveOptions.setImagesFolder("images_folder/");

// Salva il documento con le immagini
doc.save("document_with_images.md", saveOptions);

Assicurati di sostituire"document_with_images.docx" con il percorso del documento Word contenente immagini e"images_folder/" con il percorso effettivo della cartella in cui sono archiviate le immagini.

Codice sorgente completo per salvare documenti come Markdown in Aspose.Words per Java

public void autoTableContentAlignment() throws Exception
{
	Document doc = new Document();
	DocumentBuilder builder = new DocumentBuilder(doc);
	builder.insertCell();
	builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
	builder.write("Cell1");
	builder.insertCell();
	builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
	builder.write("Cell2");
	// Fa sì che tutti i paragrafi all'interno della tabella siano allineati.
	MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
	{
		saveOptions.setTableContentAlignment(TableContentAlignment.LEFT);
	}
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.LeftTableContentAlignment.md", saveOptions);
	saveOptions.setTableContentAlignment(TableContentAlignment.RIGHT);
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.RightTableContentAlignment.md", saveOptions);
	saveOptions.setTableContentAlignment(TableContentAlignment.CENTER);
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.CenterTableContentAlignment.md", saveOptions);
	// L'allineamento in questo caso verrà preso dal primo paragrafo nella colonna corrispondente della tabella.
	saveOptions.setTableContentAlignment(TableContentAlignment.AUTO);
	doc.save("Your Directory Path" + "WorkingWithMarkdownSaveOptions.AutoTableContentAlignment.md", saveOptions);
}
@Test
public void setImagesFolder() throws Exception
{
	Document doc = new Document("Your Directory Path" + "Image bullet points.docx");
	MarkdownSaveOptions saveOptions = new MarkdownSaveOptions(); { saveOptions.setImagesFolder("Your Directory Path" + "Images"); }
	try(ByteArrayOutputStream stream = new ByteArrayOutputStream())
	{
		doc.save(stream, saveOptions);
	}
}

Conclusione

In questa guida, abbiamo esplorato come salvare i documenti come Markdown utilizzando Aspose.Words per Java. Abbiamo trattato la creazione di un documento Word, la personalizzazione dell’allineamento del contenuto della tabella e la gestione delle immagini nei file Markdown. Ora puoi convertire in modo efficiente i tuoi documenti Word nel formato Markdown, rendendoli adatti a varie piattaforme di pubblicazione ed esigenze di documentazione.

Domande frequenti

Come installo Aspose.Words per Java?

Aspose.Words per Java può essere installato includendo la libreria nel tuo progetto Java. È possibile scaricare la libreria daQui e seguire le istruzioni di installazione fornite nella documentazione.

Posso convertire documenti Word complessi con tabelle e immagini in Markdown?

Sì, Aspose.Words per Java supporta la conversione di documenti Word complessi con tabelle, immagini e vari elementi di formattazione in Markdown. Puoi personalizzare l’output Markdown in base alla complessità del tuo documento.

Come posso gestire le immagini nei file Markdown?

Per includere immagini nei file Markdown, imposta il percorso della cartella delle immagini utilizzando il filesetImagesFoldermetodo dentroMarkdownSaveOptions. Assicurarsi che i file di immagine siano archiviati nella cartella specificata e Aspose.Words per Java gestirà i riferimenti alle immagini di conseguenza.

È disponibile una versione di prova di Aspose.Words per Java?

Sì, puoi ottenere una versione di prova di Aspose.Words per Java dal sito Web Aspose. La versione di prova consente di valutare le capacità della libreria prima di acquistare una licenza.

Dove posso trovare altri esempi e documentazione?

Per ulteriori esempi, documentazione e informazioni dettagliate su Aspose.Words per Java, visitare il sitodocumentazione.