as_raw_html: Get the HTML content of a *gt* table

View source: R/export.R

as_raw_htmlR Documentation

Get the HTML content of a gt table


Get the HTML content from a gt_tbl object as a single-element character vector. By default, the generated HTML will have inlined styles, where CSS styles (that were previously contained in CSS rule sets external to the ⁠<table> element⁠) are included as style attributes in the HTML table's tags. This option is preferable when using the output HTML table in an emailing context.


as_raw_html(data, inline_css = TRUE)



A table object that is created using the gt() function.


An option to supply styles to table elements as inlined CSS styles. This is useful when including the table HTML as part of an HTML email message body, since inlined styles are largely supported in email clients over using CSS in a ⁠<style>⁠ block.


Use gtcars to create a gt table. Add a header and then export as HTML code with inlined CSS styles.

tab_html <-
  gtcars |>
  dplyr::select(mfr, model, msrp) |>
  dplyr::slice(1:5) |>
  gt() |>
    title = md("Data listing from **gtcars**"),
    subtitle = md("`gtcars` is an R dataset")
  ) |>

What's returned is a single-element vector containing the HTML for the table. It has only the ⁠<table>...</table>⁠ part so it's not a complete HTML document but rather an HTML fragment.

Function ID


Function Introduced

v0.2.0.5 (March 31, 2020)

See Also

Other table export functions: as_latex(), as_rtf(), as_word(), extract_cells(), extract_summary(), gtsave()

gt documentation built on April 3, 2023, 5:18 p.m.