Maroto is a Go library for creating PDF documents with a simple and intuitive API. It provides a high-level abstraction layer over the gofpdf library, making it easier to create complex PDF layouts with tables, images, and various text styles.

Pros

• Easy to use API for creating PDF documents
• Supports complex layouts with tables, images, and text styling
• Built-in support for common elements like headers, footers, and page numbers
• Active development and community support

Cons

• Limited customization options compared to lower-level PDF libraries
• Dependency on the gofpdf library
• May have performance limitations for very large or complex documents
• Limited support for advanced PDF features like forms or interactive elements

Code Examples

Creating a simple PDF with a title and paragraph:

m := maroto.New()
m.AddPage()

m.Row(40, func() {
    m.Col(12, func() {
        m.Text("Welcome to Maroto", props.Text{
            Top:   12,
            Style: consts.Bold,
            Align: consts.Center,
            Size:  20,
        })
        m.Text("This is a simple example", props.Text{
            Top:   22,
            Align: consts.Center,
            Size:  15,
        })
    })
})

err := m.OutputFileAndClose("output.pdf")
if err != nil {
    fmt.Println("Could not save PDF:", err)
    os.Exit(1)
}

Adding a table to the PDF:

m := maroto.New()
m.AddPage()

headers := []string{"Name", "Age", "City"}
contents := [][]string{
    {"John Doe", "30", "New York"},
    {"Jane Smith", "25", "London"},
    {"Bob Johnson", "35", "Paris"},
}

m.TableList(headers, contents, props.TableList{
    HeaderProp: props.TableListContent{
        Family: consts.Arial,
        Style:  consts.Bold,
        Size:   10,
    },
    ContentProp: props.TableListContent{
        Family: consts.Courier,
        Style:  consts.Normal,
        Size:   8,
    },
    Align: consts.Center,
    AlternatedBackground: &color.Color{
        Red:   200,
        Green: 200,
        Blue:  200,
    },
    HeaderContentSpace: 4,
    Line:              true,
})

err := m.OutputFileAndClose("table_example.pdf")
if err != nil {
    fmt.Println("Could not save PDF:", err)
    os.Exit(1)
}

Getting Started

To use Maroto in your Go project, follow these steps:

1. Install the library:

   go get -u github.com/johnfercher/maroto
   

2. Import the library in your Go code:

   import (
       "github.com/johnfercher/maroto"
       "github.com/johnfercher/maroto/pkg/consts"
       "github.com/johnfercher/maroto/pkg/props"
   )
   

3. Create a new Maroto instance and start building your PDF:

   m := maroto.New()
   m.AddPage()
   // Add content to your PDF
   err := m.OutputFileAndClose("output.pdf")