Generate and Parse .docx Files via Free Go Library

Getting Started with Go-Docx

The recommended way Go-Docx into your project is by using GitHub. Please use the following command for a smooth installation.

go get -d github.com/fumiama/go-docx@latest 

Advanced Document Generation via Go

Go-Docx allows you to create complex documents from scratch using a structured approach. It handles the initialization of the document environment, including default themes and styles, ensuring that your generated files are fully compatible with Microsoft Word and other modern processors. Here is a simple example that demonstrates how to generate a Word Docx file inside Go apps.

package main
import (
	"os"
	"github.com/fumiama/go-docx"
)

func main() {
	// Initialize a new document with a default theme
	w := docx.New().WithDefaultTheme()
	
	// Add a paragraph and basic text
	para := w.AddParagraph()
	para.AddText("Hello, this is a generated document!")

	// Save to local file
	f, _ := os.Create("simple.docx")
	w.WriteTo(f)
	f.Close()
}

Comprehensive Document Parsing via Go API

Unlike many competitors, the open source Go-Docx library excels at reading existing files. It can parse a .docx file and iterate through its body items, such as paragraphs and tables. This makes it an ideal choice for data extraction or document auditing tasks where you need to analyze content programmatically. The following example shows how software developers can parse word documents inside their own Go applications.

package main
import (
	"fmt"
	"os"
	"github.com/fumiama/go-docx"
)

func main() {
	readFile, _ := os.Open("existing.docx")
	info, _ := readFile.Stat()
	
	// Parse the file using its reader and size
	doc, _ := docx.Parse(readFile, info.Size())
	
	for _, item := range doc.Document.Body.Items {
		if p, ok := item.(*docx.Paragraph); ok {
			fmt.Println("Paragraph found:", p)
		}
	}
}

Dynamic Table Construction in Docx Files via Go

Open source Go-Docx library has included support for the creation and manipulation of tables, including nested tables—a feature often missing in simpler libraries. You can define rows, cells, and specific border styles, making it highly effective for generating financial reports, invoices, or data-heavy technical documentation. Here is a very useful code example that shows how to create a table inside Word documents via Go commands.

func createTable(w *docx.Docx) {
	table := w.AddTable(2, 2) // Create a 2x2 table
	row := table.Rows[0]
	cell := row.Cells[0]
	
	p := cell.AddParagraph()
	p.AddText("Cell Content")
	
	// You can also adjust table properties here
}

Rich Text Styling and Formatting Support

Fine-grained control over typography is a core strength of this open source Go library. You can modify text color, font size, alignment, and even add hyperlinks or tab stops via Go-Docx. This allows developers to generate professional, branded documents that match specific design requirements without manual intervention.

func styleText(w *docx.Docx) {
	para := w.AddParagraph()
	// Chain styling methods for concise code
	para.AddText("Important Header").Size("32").Color("FF0000")
	para.AddText("Subtext").Italic().Bold()
	
	// Add a link
	para.AddLink("Visit Website", "https://example.com")
}