Convertir archivos Markdown a archivos Word mediante biblioteca Swift gratuita
Biblioteca Swift de código abierto para convertir archivos Markdown a documentos Word DOCX con soporte para texto, tablas, imágenes, listas, fuentes y formato personalizado.
¿Qué es MarkdownToDocx?
En el mundo de desarrollo acelerado de hoy, la capacidad de convertir contenido entre formatos sin problemas es una superpotencia. Markdown se ha convertido en el lenguaje universal para escribir documentación, publicaciones de blog y readmes debido a su simplicidad. Convertir archivos Markdown al formato Microsoft Word nunca ha sido tan fácil para los desarrolladores Swift. La biblioteca MarkdownToDocx ofrece una solución potente y flexible para transformar documentos Markdown en texto plano a archivos DOCX formateados profesionalmente. Esta guía integral explora todo lo que necesitas saber sobre esta biblioteca Swift esencial. Más allá del formato básico, la biblioteca maneja características Markdown más complejas. El texto tachado se renderiza con el formato adecuado, las citas en bloque aparecen con un estilo distintivo y las tablas se convierten conservando toda la estructura, incluidos encabezados y celdas de datos.
MarkdownToDocx es una biblioteca Swift de código abierto que convierte sin problemas documentos Markdown al formato Microsoft Word DOCX. Basada en el parser MarkdownToDocx de Apple y aprovechando ZIPFoundation para la creación de archivos, esta biblioteca cierra la brecha entre el formato de texto simple y la generación profesional de documentos. La biblioteca sobresale por su simplicidad mientras ofrece opciones avanzadas de personalización para desarrolladores que necesitan un control granular sobre el estilo del documento. Ya sea que estés construyendo una aplicación de tomar notas, un generador de documentación o un sistema de gestión de contenido, MarkdownToDocx proporciona las herramientas que necesitas.
Comenzando con MarkdownToDocx
La forma recomendada de instalar MarkdownToDocx es usando GitHub. Por favor, utiliza el siguiente comando para una instalación fluida.
Instalar MarkdownToDocx vía GitHub
$ go get https://github.com/riyadshauk/markdown-docx-swift.git Agregar MarkdownToDocx a tu proyecto requiere solo unos pocos pasos. Abre tu archivo Package.swift y agrega la dependencia:
Agregar la siguiente dependencia al argumento Dependencies
dependencies: [
.package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]
Convertir archivos Markdown a DOCX mediante Swift
La biblioteca de código abierto MarkdownToDocx incluye soporte para cargar y convertir archivos markdown a archivos Word DOCX usando comandos Swift. También puedes convertir archivos Markdown directamente sin cargarlos en memoria primero. Este enfoque es más eficiente para archivos grandes, ya que no requiere cargar todo el archivo como una cadena primero. Aquí tienes un ejemplo sencillo que muestra cómo los desarrolladores de software pueden convertir un archivo markdown a un archivo Word DOCX usando comandos Swift.
¿Cómo convertir archivos Markdown a DOCX usando la biblioteca 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)")
}
Soporte de formato de texto
La biblioteca MarkdownToDocx maneja todas las opciones esenciales de formato de texto. El texto en negrita, cursiva y tachado es totalmente compatible. Los bloques de código en línea también se renderizan correctamente, manteniendo el formato monoespaciado que distingue el código del texto regular. El siguiente ejemplo de código simple demuestra lo fácil que es convertir texto con formato. El convertidor reconoce automáticamente la sintaxis Markdown y aplica el formato correspondiente en el archivo DOCX de salida.
¿Cómo convertir texto con formato en Word DOCX mediante la biblioteca 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)
Convertir listas anidadas de Markdown mediante la biblioteca Swift
La biblioteca de código abierto MarkdownToDocx ha proporcionado soporte completo para manejar listas con viñetas y numeradas con sangría en archivos Markdown dentro de aplicaciones Swift. Tanto las listas con viñetas como las numeradas funcionan sin problemas. La biblioteca maneja correctamente listas anidadas, manteniendo la sangría y los esquemas de numeración correctos. La propiedad de sangrado en la configuración ListStyles permite ajustar la posición de los elementos anidados, asegurando que tus listas se vean exactamente como deseas. Aquí tienes un ejemplo sencillo que muestra cómo hacerlo.
¿Cómo convertir listas anidadas de Markdown mediante la biblioteca 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)
Renderizar tablas Markdown mediante la biblioteca Swift
El soporte de tablas es una de las características más destacadas. La biblioteca MarkdownToDocx interpreta correctamente las tablas Markdown y las renderiza con bordes y formato de celdas adecuados dentro de aplicaciones Swift. Las tablas mantienen su estructura perfectamente, con bordes personalizables, relleno de celdas y opciones de alineación de texto disponibles a través de la configuración de estilo. El siguiente ejemplo demuestra cómo usar la biblioteca para leer tablas Markdown y renderizarlas con bordes y formato de celdas correctos.
¿Cómo renderizar tablas Markdown mediante la biblioteca 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