1. 产品
  2.   字处理
  3.   Swift
  4.   DOCX
 
  

通过免费 Swift 库将 Markdown 文件转换为 Word 文件

开源 Swift 库，用于将 Markdown 文件转换为带有文本、表格、图片、列表、字体和自定义格式支持的 Word DOCX 文档。

MarkdownToDocx 是什么？

在当今快速发展的开发世界里，能够无缝地在不同格式之间转换内容是一种超能力。由于其简洁性，Markdown 已成为编写文档、博客文章和 README 的通用语言。对于 Swift 开发者来说，将 Markdown 文件转换为 Microsoft Word 格式从未如此简单。MarkdownToDocx 库提供了一个强大且灵活的方案，将纯文本的 Markdown 文档转化为专业排版的 DOCX 文件。本综合指南将介绍关于这款关键 Swift 库的全部必要信息。除了基本的格式化，库还处理更复杂的 Markdown 功能。删除线文本会以正确的格式呈现，块引用拥有独特的样式，表格在转换时会完整保留结构，包括表头和数据单元格。

MarkdownToDocx 是一个开源 Swift 库，能够无缝地将 Markdown 文档转换为 Microsoft Word DOCX 格式。它基于 Apple 的 MarkdownToDocx 解析器，并利用 ZIPFoundation 来创建归档文件，该库弥合了简单文本格式化与专业文档生成之间的差距。此库以其简洁性著称，同时为需要细粒度控制文档样式的开发者提供了高级自定义选项。无论你是在构建记事应用、文档生成器还是内容管理系统，MarkdownToDocx 都能提供所需的工具。

Previous Next

MarkdownToDocx 入门指南

推荐的安装 MarkdownToDocx 方法是使用 GitHub，请使用以下命令进行顺利安装。

通过 GitHub 安装 MarkdownToDocx

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

将 MarkdownToDocx 添加到你的项目只需几步。打开你的 Package.swift 文件并添加依赖项：

在 Dependencies 参数中添加以下依赖项

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

通过 Swift 将 Markdown 文件转换为 DOCX

开源的 MarkdownToDocx 库已加入使用 Swift 命令加载并转换 markdown 文件为 Word DOCX 文件的支持。你也可以直接转换 Markdown 文件而无需先将其加载到内存中。这种方式对大文件更高效，因为它无需先将整个文件加载为字符串。下面是一个简单示例，演示软件开发者如何使用 Swift 命令将 markdown 文件转换为 Word DOCX 文件。

如何使用 Swift 库将 Markdown 文件转换为 DOCX？

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)")
}

文本格式化支持

MarkdownToDocx 库处理所有基本的文本格式化选项。粗体、斜体和删除线格式均得到完整支持。内联代码块也能正确渲染，保持区分代码与普通文本的等宽格式。以下简单代码示例展示了转换格式化文本有多么轻松。转换器会自动识别 Markdown 语法，并在输出的 DOCX 文件中应用相应的格式。

如何通过 Swift 库将格式化文本转换为 Word DOCX？

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 库转换嵌套的 Markdown 列表

开源的 MarkdownToDocx 库为 Swift 应用中的 Markdown 文件提供了对缩进的项目符号列表和编号列表的完整支持。项目符号列表和编号列表都能够无缝运行。库能够正确处理嵌套列表，保持正确的缩进和编号方案。ListStyles 配置中的缩进属性允许你调整嵌套项的位置，确保列表呈现出你期望的效果。下面是一个简单示例，展示如何实现。

如何通过 Swift 库转换嵌套的 Markdown 列表？

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 库渲染 Markdown 表格

表格支持是其突出的特性之一。MarkdownToDocx 库能够正确解析 Markdown 表格，并在 Swift 应用中以合适的边框和单元格格式进行渲染。表格结构保持完整，并可通过样式配置自定义边框、单元格填充和文本对齐选项。以下示例演示了如何使用该库读取 Markdown 表格并以合适的边框和单元格格式进行渲染。

如何通过 Swift 库渲染 Markdown 表格？

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
 中国人