https://github.com/johnfercher/maroto
A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple.
https://github.com/johnfercher/maroto
bootstrap fast golang grid pdf simple
Last synced: 4 days ago
JSON representation
A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple.
- Host: GitHub
- URL: https://github.com/johnfercher/maroto
- Owner: johnfercher
- License: mit
- Created: 2019-05-20T23:27:47.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-21T14:20:13.000Z (22 days ago)
- Last Synced: 2025-04-01T19:15:09.833Z (11 days ago)
- Topics: bootstrap, fast, golang, grid, pdf, simple
- Language: Go
- Homepage: https://maroto.io
- Size: 50 MB
- Stars: 2,371
- Watchers: 27
- Forks: 228
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-go - maroto - A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple. (Template Engines / HTTP Clients)
- zero-alloc-awesome-go - maroto - A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple. (Template Engines / HTTP Clients)
- awesome-go-extra - maroto - 05-20T23:27:47Z|2022-08-23T09:16:34Z| (Template Engines / HTTP Clients)
- awesome-go - maroto - A maroto way to create PDFs. Maroto is inspired in Bootstrap and uses gofpdf. Fast and simple. Stars:`2.4K`. (Template Engines / HTTP Clients)
README
# Maroto V2
[](https://pkg.go.dev/github.com/johnfercher/maroto/v2)
[](https://goreportcard.com/report/github.com/johnfercher/maroto)
[](https://github.com/avelino/awesome-go#template-engines)
[](https://github.com/johnfercher/maroto/actions/workflows/goci.yml)
[](https://github.com/johnfercher/maroto/actions/workflows/golangci-lint.yml)
[](https://codecov.io/gh/johnfercher/maroto)
[](https://badges.pufler.dev)
[](https://github.com/johnfercher/maroto/stargazers)
A Maroto way to create PDFs. Maroto is inspired in Bootstrap and uses [Gofpdf](https://github.com/jung-kurt/gofpdf). Fast and simple.
> Maroto definition: Brazilian expression, means an astute/clever/intelligent person.
> [Art by **@marinabankr**](https://www.instagram.com/marinabankr/)
You can write your PDFs like you are creating a site using Bootstrap. A Row may have many Cols, and a Col may have many components.
Besides that, pages will be added when content may extrapolate the useful area. You can define a header which will be added
always when a new page appear, in this case, a header may have many rows, lines or tablelist.
#### Maroto `v2.3.1` is here! Try out:
* Installation with`go get`:
```bash
go get github.com/johnfercher/maroto/[email protected]
```
* You can see the full `v2` documentation [here](https://maroto.io/).
* The `v1` still exists in [this branch](https://github.com/johnfercher/maroto/tree/v1), and you can see the doc [here](https://maroto.io/#/v1/README?id=deprecated).
## Contributing
| Command | Description | Dependencies |
|-----------------|---------------------------------------------------|---------------------------------------------------------------|
| `make build` | Build project | `go` |
| `make test` | Run unit tests | `go` |
| `make fmt` | Format files | `gofmt`, `gofumpt` and `goimports` |
| `make lint` | Check files | `golangci-lint` |
| `make dod` | (Definition of Done) Format files and check files | Same as `make build`, `make test`, `make fmt` and `make lint` |
| `make install` | Install all dependencies | `go`, `curl` and `git` |
| `make examples` | Run all examples | `go` |
| `make mocks` | Generate mocks | `go` and `mockery` |
| `make docs` | Run docsify docs server local | `docsify` |
| `make godoc` | Run godoc server local | `godoc` |
## Stargazers over time
[](https://starchart.cc/johnfercher/maroto)