Converter arquivos Markdown em arquivos Word via Biblioteca Swift Gratuita
Biblioteca Swift de Código Aberto para converter arquivos Markdown em documentos Word DOCX com suporte a texto, tabelas, imagens, listas, fontes e formatação personalizada.
O que é MarkdownToDocx?
No mundo de desenvolvimento acelerado de hoje, a capacidade de converter conteúdo entre formatos de forma fluida é uma superpotência. O Markdown se tornou a linguagem universal para escrever documentação, posts de blog e readmes devido à sua simplicidade. Converter arquivos Markdown para o formato Microsoft Word nunca foi tão fácil para desenvolvedores Swift. A biblioteca MarkdownToDocx oferece uma solução poderosa e flexível para transformar documentos Markdown de texto simples em arquivos DOCX profissionalmente formatados. Este guia abrangente explora tudo o que você precisa saber sobre esta biblioteca Swift essencial. Além da formatação básica, a biblioteca lida com recursos Markdown mais complexos. Texto tachado é renderizado com formatação adequada, citações em bloco aparecem com estilo distintivo e tabelas são convertidas mantendo totalmente a estrutura, incluindo cabeçalhos e células de dados.
O MarkdownToDocx é uma biblioteca Swift de código aberto que converte documentos Markdown perfeitamente para o formato Microsoft Word DOCX. Construída sobre o parser MarkdownToDocx da Apple e utilizando o ZIPFoundation para criação de arquivos, esta biblioteca preenche a lacuna entre a formatação simples de texto e a geração profissional de documentos. A biblioteca se destaca pela sua simplicidade, oferecendo opções avançadas de customização para desenvolvedores que precisam de controle granular sobre o estilo dos documentos. Seja construindo um aplicativo de notas, um gerador de documentação ou um sistema de gerenciamento de conteúdo, o MarkdownToDocx fornece as ferramentas necessárias.
Começando com MarkdownToDocx
A forma recomendada de instalar o MarkdownToDocx é usando o GitHub. Por favor, use o comando a seguir para uma instalação tranquila.
Instalar MarkdownToDocx via GitHub
$ go get https://github.com/riyadshauk/markdown-docx-swift.git Adicionar o MarkdownToDocx ao seu projeto requer apenas alguns passos. Abra seu arquivo Package.swift e adicione a dependência:
Adicionar a seguinte dependência ao argumento Dependencies
dependencies: [
.package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]
Convertendo arquivos Markdown para DOCX via Swift
A biblioteca de código aberto MarkdownToDocx inclui suporte para carregar e converter arquivos markdown em arquivos Word DOCX usando comandos Swift. Você também pode converter arquivos Markdown diretamente sem carregá-los na memória primeiro. Essa abordagem é mais eficiente para arquivos grandes, pois não exige carregar todo o arquivo em uma string antes. Aqui está um exemplo simples que demonstra como desenvolvedores podem converter um arquivo markdown em um arquivo Word DOCX usando comandos Swift.
Como converter arquivos Markdown para DOCX usando a 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)")
}
Suporte a formatação de texto
A biblioteca MarkdownToDocx lida com todas as opções essenciais de formatação de texto. Texto em negrito, itálico e tachado são totalmente suportados. Blocos de código inline também são renderizados corretamente, mantendo a formatação monoespaçada que distingue o código do texto regular. O exemplo de código simples a seguir demonstra quão fácil é converter texto formatado. O conversor reconhece automaticamente a sintaxe Markdown e aplica a formatação correspondente no arquivo DOCX de saída.
Como converter texto formatado em Word DOCX via 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)
Converter listas Markdown aninhadas via Biblioteca Swift
A biblioteca de código aberto MarkdownToDocx oferece suporte completo ao tratamento de listas com marcadores indentados e listas numeradas em arquivos Markdown dentro de aplicativos Swift. Tanto listas com marcadores quanto listas numeradas funcionam perfeitamente. A biblioteca lida corretamente com listas aninhadas, mantendo a indentação e a numeração corretas. A propriedade de indentação na configuração ListStyles permite ajustar a posição dos itens aninhados, garantindo que suas listas apareçam exatamente como você deseja. Aqui está um exemplo simples que demonstra como fazer isso.
Como converter listas Markdown aninhadas via 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 tabelas Markdown via Biblioteca Swift
O suporte a tabelas é um dos recursos de destaque. A biblioteca MarkdownToDocx interpreta corretamente tabelas Markdown e as renderiza com bordas adequadas e formatação de células dentro de aplicações Swift. As tabelas mantêm sua estrutura perfeitamente, com bordas personalizáveis, preenchimento de células e opções de alinhamento de texto disponíveis por meio da configuração de estilo. O exemplo a seguir demonstra como usar a biblioteca para ler tabelas Markdown e renderizá‑las com bordas corretas e formatação de células.
Como renderizar tabelas Markdown via 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