Ücretsiz Swift Kütüphanesi ile Markdown Dosyalarını Word Dosyalarına Dönüştür
Metin, tablolar, resimler, listeler, yazı tipleri ve özelleştirilebilir biçimlendirme desteğiyle Markdown dosyalarını Word DOCX belgelerine dönüştüren Açık Kaynak Swift Kütüphanesi.
MarkdownToDocx nedir?
Bugünün hızlı tempolu geliştirme dünyasında, içerikleri formatlar arasında sorunsuz bir şekilde dönüştürme yeteneği bir süper güçtür. Markdown, sadeliği sayesinde dokümantasyon, blog gönderileri ve readme dosyaları yazmak için evrensel bir dil haline gelmiştir. Markdown dosyalarını Microsoft Word formatına dönüştürmek, Swift geliştiricileri için daha önce hiç bu kadar kolay olmamıştı. MarkdownToDocx kütüphanesi, düz metin Markdown belgelerini profesyonel biçimlendirilmiş DOCX dosyalarına dönüştürmek için güçlü ve esnek bir çözüm sunar. Bu kapsamlı rehber, bu önemli Swift kütüphanesi hakkında bilmeniz gereken her şeyi ele alıyor. Temel biçimlendirmenin ötesinde, kütüphane daha karmaşık Markdown özelliklerini de yönetir. Üstü çizili metin uygun biçimlendirme ile görüntülenir, blok alıntılar ayırt edici bir stil ile ortaya çıkar ve tablolar başlıklar ve veri hücreleri dahil tam yapı korunarak dönüştürülür.
MarkdownToDocx, Markdown belgelerini sorunsuz bir şekilde Microsoft Word DOCX formatına dönüştüren açık kaynaklı bir Swift kütüphanesidir. Apple'ın MarkdownToDocx ayrıştırıcısı üzerine inşa edilmiş ve arşiv oluşturmak için ZIPFoundation kullanılmıştır; bu kütüphane, basit metin biçimlendirmesi ile profesyonel belge üretimi arasındaki boşluğu doldurur. Kütüphane, basitliğiyle öne çıkarken belge stilini detaylı bir şekilde kontrol etmek isteyen geliştiriciler için gelişmiş özelleştirme seçenekleri sunar. İster bir not alma uygulaması, ister dokümantasyon oluşturucu, ister içerik yönetim sistemi geliştirin, MarkdownToDocx ihtiyacınız olan araçları sağlar.
MarkdownToDocx ile Başlarken
MarkdownToDocx'i kurmanın önerilen yolu GitHub kullanmaktır. Sorunsuz bir kurulum için lütfen aşağıdaki komutu kullanın.
MarkdownToDocx'i GitHub üzerinden Kurun
$ go get https://github.com/riyadshauk/markdown-docx-swift.git MarkdownToDocx'i projenize eklemek sadece birkaç adım gerektirir. Package.swift dosyanızı açın ve bağımlılığı ekleyin:
Aşağıdaki Bağımlılığı Dependencies Argümanına Ekleyin
dependencies: [
.package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]
Swift ile Markdown Dosyalarını DOCX'e Dönüştürme
Açık kaynaklı MarkdownToDocx kütüphanesi, Swift komutları kullanarak markdown dosyalarını Word DOCX dosyalarına yükleme ve dönüştürme desteği içerir. Ayrıca markdown dosyalarını önce belleğe yüklemeden doğrudan da dönüştürebilirsiniz. Bu yaklaşım, tüm dosyayı önce bir dizeye yüklemeyi gerektirmediği için büyük dosyalar için daha etkilidir. İşte Swift komutlarıyla bir markdown dosyasını Word DOCX dosyasına dönüştürmenin nasıl yapılacağını gösteren basit bir örnek.
Swift Kütüphanesi ile Markdown Dosyalarını DOCX'e Nasıl Dönüştürülür?
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)")
}
Metin Biçimlendirme Desteği
MarkdownToDocx kütüphanesi, tüm temel metin biçimlendirme seçeneklerini yönetir. Kalın metin, italik metin ve üzeri çizili biçimlendirme tam olarak desteklenir. Satır içi kod blokları da doğru şekilde render edilir, kodu normal metinden ayıran monospace biçimlendirmesini korur. Aşağıdaki basit kod örneği, biçimlendirilmiş metni dönüştürmenin ne kadar kolay olduğunu gösterir. Dönüştürücü, Markdown sözdizimini otomatik olarak tanır ve çıktı DOCX dosyasında ilgili biçimlendirmeyi uygular.
Swift Kütüphanesi ile Word DOCX'de Biçimlendirilmiş Metin Nasıl Dönüştürülür?
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)
Swift Kütüphanesi ile İç İçe Markdown Listelerini Dönüştürme
Açık kaynaklı MarkdownToDocx kütüphanesi, Swift uygulamalarında markdown dosyalarında girintili madde işaretli ve numaralı listeleri yönetmek için tam destek sağlar. Hem madde işaretli listeler hem de numaralı listeler sorunsuz çalışır. Kütüphane, iç içe listeleri doğru şekilde ele alır, doğru girinti ve numaralandırma şemalarını korur. ListStyles yapılandırmasındaki girinti özelliği, iç içe öğelerin nasıl konumlandırılacağını ayarlamanıza izin verir ve listelerinizin tam istediğiniz gibi görünmesini sağlar. İşte bunu gösteren basit bir örnek.
Swift Kütüphanesi ile İç İçe Markdown Listeleri Nasıl Dönüştürülür?
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)
Swift Kütüphanesi ile Markdown Tablolarını Render Etme
Tablo desteği, öne çıkan özelliklerden biridir. MarkdownToDocx kütüphanesi, Markdown tablolarını doğru şekilde yorumlar ve Swift uygulamaları içinde uygun kenarlıklar ve hücre formatlamasıyla render eder. Tablolar yapısını mükemmel bir şekilde korur; özelleştirilebilir kenarlıklar, hücre dolgu ve metin hizalama seçenekleri stil yapılandırması aracılığıyla mevcuttur. Aşağıdaki örnek, kütüphaneyi kullanarak Markdown tablolarını nasıl okuyup uygun kenarlıklar ve hücre formatlamasıyla render edeceğinizi gösterir.
Swift Kütüphanesi ile Markdown Tabloları Nasıl Render Edilir?
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