---
name: "lowdown_html_rndr"
section: "3"
platform: "linux"
package: "lowdown"
version: "3.2.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/lowdown_html_rndr"
---

# lowdown\_html\_rndr(3)

render Markdown into HTML

## NAME

**lowdown\_html\_rndr** – render Markdown into HTML

## LIBRARY

library “liblowdown”

## SYNOPSIS

**#include \<sys/queue.h\>**

**#include \<stdio.h\>**

**#include \<lowdown.h\>**

*int*\

**lowdown\_html\_rndr**(*struct lowdown\_buf \*out*, *void \*arg*, *const struct lowdown\_node \*n*);

## DESCRIPTION

Renders a node tree *n* created by [lowdown\_doc\_parse(3)](/lowdown_doc_parse/3.md) or [lowdown\_diff(3)](/lowdown_diff/3.md) using the HTML renderer *arg* as returned by [lowdown\_html\_new(3)](/lowdown_html_new/3.md). The output is written into *out*, which must be initialised and freed by the caller.

The output consists of a UTF-8 HTML5 document.

## RETURN VALUES

Returns zero on failure to allocate memory, non-zero on success.

## EXAMPLES

The following parses *b* of length *bsz* and outputs in HTML format.

```
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_html_new(NULL)) == NULL)
	err(1, NULL);
if (!lowdown_html_rndr(out, rndr, n))
	err(1, NULL);
fwrite(out->data, 1, out->size, stdout);
lowdown_html_free(rndr);
lowdown_buf_free(out);
lowdown_node_free(n);
lowdown_doc_free(doc);
```

## SEE ALSO

[lowdown(3)](/lowdown/3.md), [lowdown\_html\_free(3)](/lowdown_html_free/3.md), [lowdown\_html\_new(3)](/lowdown_html_new/3.md)

## STANDARDS

The referenced HTML5 standard is *HTML5.2:* **https://www.w3.org/TR/html52**. Output is compatible with prior HTML5 standards.
