Konwertuj pliki Markdown na pliki Word za pomocą darmowej biblioteki Swift
Otwarta biblioteka Swift do konwersji plików Markdown na dokumenty Word DOCX, z obsługą tekstu, tabel, obrazów, list, czcionek i niestandardowego formatowania.
Czym jest MarkdownToDocx?
W dzisiejszym dynamicznym świecie programistycznym zdolność płynnej konwersji treści między formatami jest supermocą. Markdown stał się uniwersalnym językiem do pisania dokumentacji, wpisów na blogu i plików readme dzięki swojej prostocie. Konwersja plików Markdown do formatu Microsoft Word nigdy nie była prostsza dla programistów Swift. Biblioteka MarkdownToDocx oferuje potężne, elastyczne rozwiązanie umożliwiające przekształcenie zwykłych dokumentów Markdown w profesjonalnie sformatowane pliki DOCX. Ten obszerny przewodnik omawia wszystko, co trzeba wiedzieć o tej niezbędnej bibliotece Swift. Poza podstawowym formatowaniem, biblioteka radzi sobie z bardziej złożonymi funkcjami Markdown. Tekst przekreślony jest renderowany z odpowiednim formatowaniem, cytaty blokowe pojawiają się ze charakterystycznym stylem, a tabele konwertowane są z zachowaniem pełnej struktury, włączając nagłówki i komórki danych.
MarkdownToDocx to otwartoźródłowa biblioteka Swift, która płynnie konwertuje dokumenty Markdown do formatu Microsoft Word DOCX. Zbudowana na parserze MarkdownToDocx firmy Apple i wykorzystująca ZIPFoundation do tworzenia archiwów, biblioteka ta łączy prostą formatację tekstu z profesjonalnym generowaniem dokumentów. Biblioteka wyróżnia się prostotą, jednocześnie oferując zaawansowane opcje dostosowywania dla programistów, którzy potrzebują precyzyjnej kontroli nad stylizacją dokumentów. Niezależnie od tego, czy tworzysz aplikację do notatek, generator dokumentacji czy system zarządzania treścią, MarkdownToDocx dostarcza niezbędne narzędzia.
Pierwsze kroki z MarkdownToDocx
Zalecanym sposobem instalacji MarkdownToDocx jest użycie GitHub. Proszę użyć poniższego polecenia, aby przeprowadzić płynną instalację.
Zainstaluj MarkdownToDocx przez GitHub
$ go get https://github.com/riyadshauk/markdown-docx-swift.git Dodanie MarkdownToDocx do projektu wymaga kilku prostych kroków. Otwórz plik Package.swift i dodaj zależność:
Dodaj następującą zależność do argumentu Dependencies
dependencies: [
.package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]
Konwertowanie plików Markdown do DOCX za pomocą Swift
Otwartoźródłowa biblioteka MarkdownToDocx zawiera wsparcie dla ładowania i konwersji plików markdown do plików Word DOCX przy użyciu poleceń Swift. Można również konwertować pliki Markdown bezpośrednio, bez wczytywania ich najpierw do pamięci. Takie podejście jest bardziej efektywne przy dużych plikach, ponieważ nie wymaga ładowania całego pliku do łańcucha znaków najpierw. Oto prosty przykład pokazujący, jak programiści mogą konwertować plik markdown na plik Word DOCX przy użyciu poleceń Swift.
Jak konwertować pliki Markdown do DOCX przy użyciu biblioteki 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)")
}
Wsparcie formatowania tekstu
Biblioteka MarkdownToDocx obsługuje wszystkie niezbędne opcje formatowania tekstu. Pogrubiony tekst, kursywa i formatowanie przekreślenia są w pełni wspierane. Inline'owe bloki kodu również są renderowane poprawnie, zachowując formatowanie monospaced, które odróżnia kod od zwykłego tekstu. Poniższy prosty przykład kodu pokazuje, jak łatwo jest konwertować sformatowany tekst. Konwerter automatycznie rozpoznaje składnię Markdown i stosuje odpowiednie formatowanie w wyjściowym pliku DOCX.
Jak konwertować sformatowany tekst w Word DOCX za pomocą biblioteki 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)
Konwertuj zagnieżdżone listy Markdown za pomocą biblioteki Swift
Otwartoźródłowa biblioteka MarkdownToDocx zapewnia pełne wsparcie dla obsługi wciętych list punktowanych i numerowanych w plikach Markdown w aplikacjach Swift. Zarówno listy punktowane, jak i numerowane działają bezproblemowo. Biblioteka prawidłowo obsługuje listy zagnieżdżone, utrzymując właściwe wcięcia i schematy numeracji. Właściwość wcięcia w konfiguracji ListStyles pozwala dostosować pozycję elementów zagnieżdżonych, zapewniając, że listy wyglądają dokładnie tak, jak chcesz. Oto prosty przykład pokazujący, jak to zrobić.
Jak konwertować zagnieżdżone listy Markdown za pomocą biblioteki 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)
Renderowanie tabel Markdown za pomocą biblioteki Swift
Obsługa tabel jest jedną z wyróżniających się funkcji. Biblioteka MarkdownToDocx prawidłowo interpretuje tabele Markdown i renderuje je z odpowiednimi ramkami oraz formatowaniem komórek w aplikacjach Swift. Tabele zachowują swoją strukturę idealnie, z możliwością dostosowania ram, wcięć komórek oraz opcji wyrównania tekstu dostępnych w konfiguracji stylów. Poniższy przykład pokazuje, jak używać biblioteki do odczytu tabel Markdown i renderować je z prawidłowymi ramkami i formatowaniem komórek.
Jak renderować tabele Markdown za pomocą biblioteki 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