Convertir des fichiers Markdown en fichiers Word via une bibliothèque Swift gratuite
Bibliothèque Swift open source pour convertir des fichiers Markdown en documents Word DOCX avec prise en charge du texte, des tableaux, des images, des listes, des polices et du formatage personnalisé.
Qu'est-ce que MarkdownToDocx ?
Dans le monde du développement d'aujourd'hui, où tout évolue rapidement, la capacité de convertir du contenu entre formats de manière fluide est une superpuissance. Markdown est devenu le langage universel pour rédiger de la documentation, des articles de blog et des fichiers readme grâce à sa simplicité. Convertir des fichiers Markdown au format Microsoft Word n'a jamais été aussi facile pour les développeurs Swift. La bibliothèque MarkdownToDocx offre une solution puissante et flexible pour transformer des documents Markdown en texte brut en fichiers DOCX formatés professionnellement. Ce guide complet explore tout ce que vous devez savoir sur cette bibliothèque Swift essentielle. Au-delà du formatage de base, la bibliothèque gère des fonctionnalités Markdown plus complexes. Le texte barré s'affiche avec le bon formatage, les blockquotes apparaissent avec un style distinctif et les tableaux sont convertis en conservant toute leur structure, y compris les en-têtes et les cellules de données.
MarkdownToDocx est une bibliothèque Swift open source qui convertit de façon fluide des documents Markdown au format Microsoft Word DOCX. Basée sur le parseur MarkdownToDocx d'Apple et utilisant ZIPFoundation pour la création d'archives, cette bibliothèque comble le fossé entre le formatage de texte simple et la génération professionnelle de documents. Elle excelle par sa simplicité tout en offrant des options avancées de personnalisation pour les développeurs qui ont besoin d'un contrôle granulaire du style des documents. Que vous créiez une application de prise de notes, un générateur de documentation ou un système de gestion de contenu, MarkdownToDocx fournit les outils nécessaires.
Premiers pas avec MarkdownToDocx
La méthode recommandée pour installer MarkdownToDocx est d'utiliser GitHub. Veuillez utiliser la commande suivante pour une installation fluide.
Installer MarkdownToDocx via GitHub
$ go get https://github.com/riyadshauk/markdown-docx-swift.git Ajouter MarkdownToDocx à votre projet ne nécessite que quelques étapes. Ouvrez votre fichier Package.swift et ajoutez la dépendance :
Ajouter la dépendance suivante à l'argument Dependencies
dependencies: [
.package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]
Conversion de fichiers Markdown en DOCX via Swift
La bibliothèque open source MarkdownToDocx inclut le support du chargement et de la conversion des fichiers markdown en fichiers Word DOCX en utilisant des commandes Swift. Vous pouvez également convertir les fichiers Markdown directement sans les charger d'abord en mémoire. Cette approche est plus efficace pour les gros fichiers, car elle ne nécessite pas de charger tout le fichier en tant que chaîne au préalable. Voici un exemple simple qui montre comment les développeurs peuvent convertir un fichier markdown en fichier Word DOCX en utilisant des commandes Swift.
Comment convertir des fichiers Markdown en DOCX en utilisant la bibliothèque Swift ?
import MarkdownToDocx
let inputURL = FileManager.default.urls(
for: .documentDirectory,
in: .userDomainMask
)[0].appendingPathComponent("input.md")
let outputURL = FileManager.default.urls(
for: .documentDirectory,
in: .userDomainMask
)[0].appendingPathComponent("output.docx")
do {
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdownFile: inputURL)
try docxData.write(to: outputURL)
print("File converted successfully!")
} catch {
print("Conversion error: \(error)")
}
Prise en charge du formatage du texte
La bibliothèque MarkdownToDocx gère toutes les options essentielles de formatage du texte. Le texte en gras, en italique et barré est entièrement supporté. Les blocs de code en ligne sont également rendus correctement, préservant le format monospace qui distingue le code du texte normal. L'exemple de code simple suivant montre à quel point il est facile de convertir du texte formaté. Le convertisseur reconnaît automatiquement la syntaxe Markdown et applique le formatage correspondant dans le fichier DOCX de sortie.
Comment convertir du texte formaté en Word DOCX via la bibliothèque Swift ?
let markdown = """
This is **bold text** and this is *italic text*.
You can also use ~~strikethrough~~ formatting.
Here's some `inline code` in the middle of a sentence.
"""
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdown: markdown)
try docxData.write(to: outputURL)
Conversion de listes Markdown imbriquées via la bibliothèque Swift
La bibliothèque open source MarkdownToDocx offre un support complet pour la gestion des listes à puces indentées et des listes numérotées dans les fichiers Markdown au sein des applications Swift. Les deux types de listes fonctionnent de manière fluide. La bibliothèque gère correctement les listes imbriquées, en maintenant la bonne indentation et les schémas de numérotation. La propriété d'indentation dans la configuration ListStyles vous permet d'ajuster la position des éléments imbriqués, garantissant que vos listes apparaissent exactement comme vous le souhaitez. Voici un exemple simple qui montre comment procéder.
Comment convertir des listes Markdown imbriquées via la bibliothèque Swift ?
let markdown = """
## Shopping List
- Fruits
- Apples
- Bananas
- Oranges
- Vegetables
- Carrots
- Broccoli
## Steps to Follow
1. First step
2. Second step
1. Sub-step one
2. Sub-step two
3. Third step
"""
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdown: markdown)
Rendu des tableaux Markdown via la bibliothèque Swift
Le support des tableaux est l'une des fonctionnalités les plus remarquables. La bibliothèque MarkdownToDocx interprète correctement les tableaux Markdown et les rend avec des bordures appropriées et un formatage des cellules dans les applications Swift. Les tableaux conservent parfaitement leur structure, avec des bordures personnalisables, un remplissage des cellules et des options d'alignement du texte disponibles via la configuration de style. L'exemple suivant montre comment utiliser la bibliothèque pour lire des tableaux Markdown et les rendre avec les bordures et le formatage de cellules corrects.
Comment rendre les tableaux Markdown via la bibliothèque Swift ?
let markdown = """
| Feature | Status | Notes |
|---------|--------|-------|
| Headings | ✅ | All levels supported |
| Lists | ✅ | Nested lists work |
| Tables | ✅ | Full support |
| Images | ✅ | Basic support |
"""
let converter = MarkdownToDocxConverter()
let docxData = try converter.convert(markdown: markdown)
Parse Markdown Documents via Swift API