Chuyển đổi các tệp Markdown sang tệp Word qua Thư viện Swift miễn phí

Thư viện Swift mã nguồn mở để chuyển đổi các tệp Markdown sang tài liệu Word DOCX với hỗ trợ văn bản, bảng, hình ảnh, danh sách, phông chữ và định dạng tùy chỉnh.

MarkdownToDocx là gì?

Trong thế giới phát triển nhanh chóng ngày nay, khả năng chuyển đổi nội dung giữa các định dạng một cách liền mạch là một siêu năng lực. Markdown đã trở thành ngôn ngữ chung để viết tài liệu, bài blog và file readme nhờ sự đơn giản của nó. Việc chuyển đổi các tệp Markdown sang định dạng Microsoft Word chưa bao giờ dễ dàng hơn đối với các nhà phát triển Swift. Thư viện MarkdownToDocx cung cấp giải pháp mạnh mẽ, linh hoạt để biến các tài liệu Markdown dạng văn bản thuần thành các tệp DOCX được định dạng chuyên nghiệp. Hướng dẫn toàn diện này khám phá mọi thứ bạn cần biết về thư viện Swift quan trọng này. Ngoài việc định dạng cơ bản, thư viện còn xử lý các tính năng Markdown phức tạp hơn. Văn bản gạch ngang được hiển thị với định dạng đúng, trích dẫn khối xuất hiện với kiểu dáng đặc biệt, và bảng được chuyển đổi với việc giữ toàn bộ cấu trúc bao gồm tiêu đề và ô dữ liệu.

MarkdownToDocx là một thư viện Swift mã nguồn mở chuyển đổi các tài liệu Markdown một cách liền mạch sang định dạng Microsoft Word DOCX. Được xây dựng dựa trên bộ phân tích MarkdownToDocx của Apple và tận dụng ZIPFoundation để tạo kho lưu trữ, thư viện này kết nối khoảng cách giữa định dạng văn bản đơn giản và việc tạo tài liệu chuyên nghiệp. Thư viện nổi bật với sự đơn giản đồng thời cung cấp các tùy chọn tùy chỉnh nâng cao cho các nhà phát triển cần kiểm soát chi tiết phong cách tài liệu. Dù bạn đang xây dựng một ứng dụng ghi chú, công cụ tạo tài liệu hay hệ thống quản lý nội dung, MarkdownToDocx cung cấp các công cụ cần thiết.

Previous Next

Bắt đầu với MarkdownToDocx

Cách đề xuất để cài đặt MarkdownToDocx là sử dụng GitHub, vui lòng dùng lệnh sau để cài đặt suôn sẻ.

Cài đặt MarkdownToDocx qua GitHub

$ go get https://github.com/riyadshauk/markdown-docx-swift.git   

Thêm MarkdownToDocx vào dự án của bạn chỉ cần vài bước. Mở file Package.swift và thêm dependency:

Thêm Dependency sau vào tham số Dependencies

dependencies: [
    .package(url: "https://github.com/riyadshauk/markdown-docx-swift.git", from: "1.0.0")
]

Chuyển đổi các tệp Markdown sang DOCX qua Swift

Thư viện MarkdownToDocx mã nguồn mở đã bao gồm hỗ trợ tải và chuyển đổi các tệp markdown sang tệp Word DOCX bằng các lệnh Swift. Bạn cũng có thể chuyển đổi các tệp Markdown trực tiếp mà không cần tải chúng vào bộ nhớ trước. Cách tiếp cận này hiệu quả hơn cho các tệp lớn vì không yêu cầu tải toàn bộ tệp vào một chuỗi trước. Dưới đây là một ví dụ đơn giản minh họa cách các nhà phát triển phần mềm có thể chuyển đổi một tệp markdown thành tệp Word DOCX bằng các lệnh Swift.

Cách chuyển đổi các tệp Markdown sang DOCX bằng Thư viện 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)")
}

Hỗ trợ định dạng văn bản

Thư viện MarkdownToDocx xử lý tất cả các tùy chọn định dạng văn bản thiết yếu. Văn bản in đậm, in nghiêng và gạch ngang đều được hỗ trợ đầy đủ. Các khối mã nội dòng cũng được hiển thị đúng, giữ định dạng monospace phân biệt mã với văn bản thường. Ví dụ mã đơn giản dưới đây cho thấy việc chuyển đổi văn bản định dạng rất dễ dàng. Trình chuyển đổi tự động nhận diện cú pháp Markdown và áp dụng định dạng tương ứng trong tệp DOCX đầu ra.

Cách chuyển đổi văn bản đã định dạng trong Word DOCX qua Thư viện 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)

Chuyển đổi danh sách Markdown lồng nhau qua Thư viện Swift

Thư viện MarkdownToDocx mã nguồn mở đã cung cấp hỗ trợ đầy đủ cho việc xử lý các danh sách gạch đầu dòng và danh sách đánh số có thụt lề trong tệp Markdown trong các ứng dụng Swift. Cả danh sách gạch đầu dòng và danh sách đánh số đều hoạt động mượt mà. Thư viện xử lý đúng các danh sách lồng nhau, duy trì thụt lề và quy tắc đánh số chính xác. Thuộc tính thụt lề trong cấu hình ListStyles cho phép bạn điều chỉnh vị trí của các mục lồng nhau, đảm bảo danh sách của bạn hiển thị chính xác như mong muốn. Dưới đây là một ví dụ đơn giản minh họa cách thực hiện.

Cách chuyển đổi danh sách Markdown lồng nhau qua Thư viện 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)

Hiển thị bảng Markdown qua Thư viện Swift

Hỗ trợ bảng là một trong những tính năng nổi bật. Thư viện MarkdownToDocx diễn giải đúng các bảng Markdown và hiển thị chúng với đường viền và định dạng ô chính xác trong các ứng dụng Swift. Các bảng duy trì cấu trúc hoàn hảo, với các đường viền có thể tùy chỉnh, khoảng cách ô và tùy chọn căn chỉnh văn bản thông qua cấu hình kiểu. Ví dụ dưới đây minh họa cách sử dụng thư viện để đọc các bảng Markdown và hiển thị chúng với đường viền và định dạng ô thích hợp.

Cách hiển thị bảng Markdown qua Thư viện 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
 Tiếng Việt