Enregistrement de documents au format Markdown dans Aspose.Words pour Java

Introduction à l’enregistrement de documents au format Markdown dans Aspose.Words pour Java

Dans ce guide étape par étape, nous montrerons comment enregistrer des documents au format Markdown à l’aide d’Aspose.Words pour Java. Markdown est un langage de balisage léger couramment utilisé pour formater des documents texte. Avec Aspose.Words pour Java, vous pouvez facilement convertir vos documents Word au format Markdown. Nous aborderons différents aspects de l’enregistrement des fichiers Markdown, notamment l’alignement du contenu des tableaux et la gestion des images.

Conditions préalables

Avant de commencer, assurez-vous de disposer des prérequis suivants :

• Kit de développement Java (JDK) installé sur votre système.
• Bibliothèque Aspose.Words pour Java. Vous pouvez le télécharger depuisici.

Étape 1 : Création d’un document Word

Commençons par créer un document Word que nous convertirons ultérieurement au format Markdown. Vous pouvez personnaliser ce document selon vos besoins.

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

// Insérer un tableau avec deux cellules
builder.insertCell();
builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
builder.write("Cell1");

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

// Enregistrez le document sous Markdown
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
doc.save("output.md", saveOptions);

Dans cet exemple, nous créons un tableau simple avec deux cellules et définissons l’alignement des paragraphes à l’intérieur de ces cellules. Ensuite, nous enregistrons le document au format Markdown en utilisant leMarkdownSaveOptions.

Étape 2 : Personnaliser l’alignement du contenu du tableau

Aspose.Words for Java vous permet de personnaliser l’alignement du contenu du tableau lors de l’enregistrement au format Markdown. Vous pouvez aligner le contenu du tableau à gauche, à droite, au centre ou le laisser être déterminé automatiquement en fonction du premier paragraphe de chaque colonne du tableau.

Voici comment personnaliser l’alignement du contenu du tableau :

// Définir l'alignement du contenu du tableau à gauche
saveOptions.setTableContentAlignment(TableContentAlignment.LEFT);
doc.save("left_alignment.md", saveOptions);

// Définir l'alignement du contenu du tableau à droite
saveOptions.setTableContentAlignment(TableContentAlignment.RIGHT);
doc.save("right_alignment.md", saveOptions);

// Définir l'alignement du contenu du tableau au centre
saveOptions.setTableContentAlignment(TableContentAlignment.CENTER);
doc.save("center_alignment.md", saveOptions);

//Définissez l'alignement du contenu du tableau sur automatique (déterminé par le premier paragraphe)
saveOptions.setTableContentAlignment(TableContentAlignment.AUTO);
doc.save("auto_alignment.md", saveOptions);

En changeant leTableContentAlignment propriété, vous pouvez contrôler la manière dont le contenu des tableaux est aligné lors de la conversion en Markdown.

Étape 3 : Gestion des images

Pour inclure des images dans votre document Markdown, vous devez spécifier le dossier où se trouvent les images. Aspose.Words for Java vous permet de définir le dossier images dans leMarkdownSaveOptions.

Voici comment définir le dossier images et enregistrer le document avec les images :

// Charger un document contenant des images
Document doc = new Document("document_with_images.docx");

// Définir le chemin du dossier images
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
saveOptions.setImagesFolder("images_folder/");

// Enregistrez le document avec les images
doc.save("document_with_images.md", saveOptions);

Assurez-vous de remplacer"document_with_images.docx" avec le chemin d’accès à votre document Word contenant des images et"images_folder/" avec le chemin réel vers le dossier où vos images sont stockées.

Code source complet pour enregistrer des documents en tant que Markdown dans Aspose.Words pour 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");
	// Aligne tous les paragraphes du tableau.
	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);
	// Dans ce cas, l'alignement sera pris à partir du premier paragraphe de la colonne correspondante du tableau.
	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);
	}
}

Conclusion

Dans ce guide, nous avons exploré comment enregistrer des documents au format Markdown à l’aide d’Aspose.Words pour Java. Nous avons couvert la création d’un document Word, la personnalisation de l’alignement du contenu du tableau et la gestion des images dans les fichiers Markdown. Vous pouvez désormais convertir efficacement vos documents Word au format Markdown, les rendant ainsi adaptés à diverses plates-formes de publication et besoins de documentation.

FAQ

Comment installer Aspose.Words pour Java ?

Aspose.Words for Java peut être installé en incluant la bibliothèque dans votre projet Java. Vous pouvez télécharger la bibliothèque depuisici et suivez les instructions d’installation fournies dans la documentation.

Puis-je convertir des documents Word complexes contenant des tableaux et des images en Markdown ?

Oui, Aspose.Words for Java prend en charge la conversion de documents Word complexes contenant des tableaux, des images et divers éléments de formatage vers Markdown. Vous pouvez personnaliser la sortie Markdown en fonction de la complexité de votre document.

Comment puis-je gérer les images dans les fichiers Markdown ?

Pour inclure des images dans des fichiers Markdown, définissez le chemin du dossier images à l’aide dusetImagesFolderméthode dansMarkdownSaveOptions. Assurez-vous que les fichiers image sont stockés dans le dossier spécifié et Aspose.Words for Java gérera les références d’image en conséquence.

Existe-t-il une version d’essai d’Aspose.Words pour Java disponible ?

Oui, vous pouvez obtenir une version d’essai d’Aspose.Words pour Java sur le site Web d’Aspose. La version d’essai vous permet d’évaluer les capacités de la bibliothèque avant d’acheter une licence.

Où puis-je trouver plus d’exemples et de documentation ?

Pour plus d’exemples, de Documentation et d’informations détaillées sur Aspose.Words pour Java, veuillez visiter ledocumentation.