LOWDOWN_LATEX_NEW(3)

📦
version 3.2.1 · 3 versions
, in alpine 3.24, arch rolling, nixpkgs unstable, ubuntu stonking

✨ LOWDOWN_LATEX_NEW(3) ✨

okay so bestie, welcome to the Library Functions Manual page for lowdown_latex_new, which is part of the library “liblowdown” 💅 she's giving very much "I make LaTeX out of Markdown" and honestly? obsessed.

🎀 NAME 🎀

lowdown_latex_new — allocate a Markdown LaTeX renderer

like... she builds you a renderer. a LaTeX one. for Markdown. that's the whole job. iconic behavior fr fr ✨

📚 LIBRARY 📚

library “liblowdown” 🫶

🦋 SYNOPSIS 🦋

#include <sys/queue.h>
#include <stdio.h>
#include <lowdown.h>

void *
lowdown_latex_new(const struct lowdown_opts *opts);

ngl that's the whole vibe right there. one function, one pointer argument, no drama 🎀

💖 DESCRIPTION 💖

So basically? lowdown_latex_new allocates a LaTeX renderer, and it sets it up using opts->flags — or, if opts is NULL, it just uses zero instead. no cap. 🫶

That flags field? it's documented over in lowdown(3), so if you wanna know what's in there, that's your girl.

The pointer you get back is reusable — you can hit lowdown_latex_rndr(3) with it multiple times, like, as many invocations as you want, she doesn't mind 💅 — but when you're done being obsessed with her, you must free her with lowdown_latex_free(3). periodt. no leaks allowed in this group chat 🌸

Now, the bits that are actually recognised inside opts->oflags are:

  • LOWDOWN_LATEX_NUMBERED
  • LOWDOWN_SKIP_HTML
  • LOWDOWN_STANDALONE

those three, and like, only those three. iykyk ✨

🌈 RETURN VALUES 🌈

She hands you a pointer to the renderer 💖 — or NULL if memory failure happens (rip, tragic, we've all been there 😭).

And yes, bestie, one more time for the people in the back: the returned pointer must be freed with lowdown_latex_free(3). that's not a suggestion, that's the law 🔥

🍓 EXAMPLES 🍓

okay so here's the moment you've been waiting for. this little number parses b of length bsz and outputs in LaTeX format. slay.

struct lowdown_buf *out;
struct lowdown_doc *doc;
struct lowdown_node *n;
void *rndr;

if ((doc = lowdown_doc_new(NULL)) == NULL)
        err(1, NULL);
if ((n = lowdown_doc_parse(doc, NULL, b, bsz, NULL)) == NULL)
        err(1, NULL);
if ((out = lowdown_buf_new(256)) == NULL)
        err(1, NULL);
if ((rndr = lowdown_latex_new(NULL)) == NULL)
        err(1, NULL);
if (!lowdown_latex_rndr(out, rndr, n))
        err(1, NULL);

fwrite(out->data, 1, out->size, stdout);

lowdown_latex_free(rndr);
lowdown_buf_free(out);
lowdown_node_free(n);
lowdown_doc_free(doc);

look at that cleanup at the bottom. four frees, in order, gorgeous, no notes 👑 that's main character energy right there.

👀 SEE ALSO 👀

go read them, they're all part of the same friend group 🦋

and that's the page, bestie 💜 this one came from Debian, version $Mdocdate$, filed under LOWDOWN_LATEX_NEW(3). now go free your renderer, drink some water, and slay the rest of your day 🎀✨

📦 where this page comes from