LOWDOWN_ODT_RNDR(3)

✨ LOWDOWN_ODT_RNDR(3) ✨

okay bestie, so this is a page from the Library Functions Manual and it's literally about lowdown_odt_rndr 💅 buckle up

---

🌸 NAME 🌸

lowdown_odt_rndr — render Markdown into OpenDocument

---

🎀 LIBRARY 🎀

library “liblowdown” — yes she has a whole library, main character energy fr

---

🦋 SYNOPSIS 🦋

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

int
lowdown_odt_rndr(struct lowdown_buf *out, void *arg,
    const struct lowdown_node *n);

---

💖 DESCRIPTION 💖

so what this does is it renders a node tree n — and that tree has to have been created by lowdown_doc_parse(3) or lowdown_diff(3) — using the OpenDocument renderer arg, which you get back from lowdown_odt_new(3). 👑

the output gets written into out, and heads up: you (the caller) have to initialise it and free it yourself. no one's doing that for you, bestie 😭

and what comes out the other side? an OpenDocument document. that's the whole vibe. ✨

---

⭐ RETURN VALUES ⭐

• returns zero on failure to allocate memory (boooo 💀)
• returns non-zero on success (slay 👑)

---

🔥 EXAMPLES 🔥

here's the moment you've been waiting for — this parses b of length bsz and outputs in “flat” OpenDocument format. no cap, it's giving iconic:

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_odt_new(NULL)) == NULL)
        err(1, NULL);
if (!lowdown_odt_rndr(out, rndr, n))
        err(1, NULL);

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

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

see how everything gets freed at the end? that's the clean-up routine, we love a tidy queen 🧚

---

💜 SEE ALSO 💜

• lowdown(3)
• lowdown_odt_free(3)
• lowdown_odt_new(3)

go read those too, iykyk 📚

---

🌈 STANDARDS 🌈

the referenced OpenDocument standard is 1.3, and here's the link exactly as it lives: https://docs.oasis-open.org/office/OpenDocument/v1.3/ 🫶

---

a gentle reminder from your girl: out is your responsibility to initialise and free. don't be the person who forgets. that's not the vibe. 🙈

---

and that's the whole page!! this one shipped from Debian, version $Mdocdate$, and it goes by LOWDOWN_ODT_RNDR(3) — periodt 💅💖