mate is a Python application for creating presentations by writing Markdown files. The goal is to build aesthetically pleasing presentations in a short amount of time while staying highly customizable and versatile: the content is plain Markdown, and the details can be tweaked with a short, clean syntax (or at least that's the intention).
The idea behind mate is to create slides fast, in a declarative and programmatic way, and let the template take care of arranging things and giving them their look. Since the content knows nothing about the aesthetics, restyling a whole presentation amounts to switching its template.
Templates get a lot of freedom and tools, and they are constructive: a template can be as small as a background change or as ambitious as a full visual identity, with its own functions and slide designs, and a deck can combine several of them.
Features
- Slides are written in plain Markdown:
#opens a slide, and bold, italics, code and math work as usual. - Whatever Markdown cannot express, the extended syntax can: any element of a slide can be created, styled, positioned and aligned.
- Templates control fonts, colors, backgrounds and slide logic. Use a built-in one, or write your own as a small Python file next to your deck.
- Slides reveal their content in stages, with a versatile system of pauses, in-place reveals and overwrites.
- There is a drawing API as well: shapes, Bézier curves, images and gradients can go on a slide alongside the text.
mateis fast: everything is heavily cached, so builds stay quick even for large decks.- There is nothing else to install: no LaTeX, no external tools. The rendering backend ships inside the package.
Getting started
To get mate, all you need is yerba:
pip install yerba
Write a deck:
# A slide title
Some content with **bold**, _italic_ and inline $x^2$ math.
Words can be styled in place: [this is red][color="red"], and
[this is translucent and smaller][opacity=0.4, fontsize=7].
> pause
- Bullet points work as usual
- and this list appears after the pause.
# Another slide
## With a subtitle
More content.
and build it:
mate slides.md
The PDF lands next to the source, as slides.pdf.
See the docs for the full Markdown syntax, front matter, templates, and the Python API.
Backends
The code is built to support different backends. Typst is the only one supported today; new backends will follow once the current one is fully functional and free of known bugs.
License
MIT. The bundled fonts keep their own licenses (SIL OFL 1.1, under fonts/).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yerba-0.3.0.tar.gz.
File metadata
- Download URL: yerba-0.3.0.tar.gz
- Upload date:
- Size: 723.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a862dcd06caba007f6269a31a474415646136320b541ccf154e62ea0879be46
|
|
| MD5 |
f602a4529c95cdba4da1039aa023f101
|
|
| BLAKE2b-256 |
aa0babbf14594ce291943ea32f8fcd9de745569b70826da59e1d6ed08ec42644
|
Provenance
The following attestation bundles were made for yerba-0.3.0.tar.gz:
Publisher:
publish.yml on bersp/mate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yerba-0.3.0.tar.gz -
Subject digest:
8a862dcd06caba007f6269a31a474415646136320b541ccf154e62ea0879be46 - Sigstore transparency entry: 2254759899
- Sigstore integration time:
-
Permalink:
bersp/mate@505eb78f996fcaaba50c74f63cd8a0b8c02c39cf -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/bersp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@505eb78f996fcaaba50c74f63cd8a0b8c02c39cf -
Trigger Event:
push
-
Statement type:
File details
Details for the file yerba-0.3.0-py3-none-any.whl.
File metadata
- Download URL: yerba-0.3.0-py3-none-any.whl
- Upload date:
- Size: 738.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fad5ad96262e0aa888271871f63cfd352b8ee5f546e4202bc14bb4ba001a897c
|
|
| MD5 |
e3dc3623e5e919f3ae193d7fb2271e34
|
|
| BLAKE2b-256 |
b300e9dc17811db60ff5be29d60602a36467f4edfbc6e837cab556b5f54d09c6
|
Provenance
The following attestation bundles were made for yerba-0.3.0-py3-none-any.whl:
Publisher:
publish.yml on bersp/mate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yerba-0.3.0-py3-none-any.whl -
Subject digest:
fad5ad96262e0aa888271871f63cfd352b8ee5f546e4202bc14bb4ba001a897c - Sigstore transparency entry: 2254759966
- Sigstore integration time:
-
Permalink:
bersp/mate@505eb78f996fcaaba50c74f63cd8a0b8c02c39cf -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/bersp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@505eb78f996fcaaba50c74f63cd8a0b8c02c39cf -
Trigger Event:
push
-
Statement type:
