knitr's kable function is the foundation of this package. However, it has many latex/html specific arguments hidden under the ground unless you check its source code. This wrapper function is created to provide better documentation (and auto-complete yay) and at the same time, solve the auto format setting in a better way.
kbl( x, format, digits = getOption("digits"), row.names = NA, col.names = NA, align, caption = NULL, label = NULL, format.args = list(), escape = TRUE, table.attr = "", booktabs = FALSE, longtable = FALSE, valign = "t", position = "", centering = TRUE, vline = getOption("knitr.table.vline", if (booktabs) "" else "|"), toprule = getOption("knitr.table.toprule", if (booktabs) "\\toprule" else "\\hline"), bottomrule = getOption("knitr.table.bottomrule", if (booktabs) "\\bottomrule" else "\\hline"), midrule = getOption("knitr.table.midrule", if (booktabs) "\\midrule" else "\\hline"), linesep = if (booktabs) c("", "", "", "", "\\addlinespace") else "\\hline", caption.short = "", table.envir = if (!is.null(caption)) "table", ... )
x is an R object, which is typically a
matrix or data frame. For
kables(), a list with each element being a
returned value from
A character string. Possible values are
pipe (Pandoc's pipe tables),
simple tables), and
rst. The value of this argument will be
automatically determined if the function is called within a knitr
format value can also be set in the global option
format is a function, it must return a
Maximum number of digits for numeric columns, passed to
round(). This can also be a vector of length
ncol(x), to set
the number of digits for individual columns.
Logical: whether to include row names. By default, row names
are included if
rownames(x) is neither
NULL nor identical to
A character vector of column names to be used in the table.
Column alignment: a character vector consisting of
'c' (center) and/or
'r' (right). By default or if
align = NULL, numeric columns are right-aligned, and other columns
are left-aligned. If
length(align) == 1L, the string will be
expanded to a vector of individual letters, e.g.
c('c', 'l', 'c'), unless the output format is LaTeX.
The table caption.
The table reference label. By default, the label is obtained
A list of arguments to be passed to
to format table values, e.g.
list(big.mark = ',').
Boolean; whether to escape special characters when producing
HTML or LaTeX tables. When
escape = FALSE, you have to make sure
that special characters will not trigger syntax errors in LaTeX or HTML.
A character string for addition HTML table attributes. This is convenient if you simply want to add a few HTML classes or styles. For example, you can put 'class="table" style="color: red"'.
T/F for whether to enable the booktabs format for tables. I personally would recommend you turn this on for every latex table except some special cases.
T/F for whether to use the longtable format. If you have a table that will span over two or more pages, you will have to turn this on.
You probably won't need to adjust this latex option very often.
If you are familar with latex tables, this is the optional position for the
tabular environment controling the vertical position of the table relative
to the baseline of the surrounding text. Possible choices are
This is the "real" or say floating position for the latex
table environment. The
kable only puts tables in a table environment when
a caption is provided. That is also the reason why your tables will be
floating around if you specify captions for your table. Possible choices are
t (top, default),
b (bottom) and
p (on a dedicated page).
T (default)/F. Whether to center tables in the table environment.
vertical separator. Default is nothing for booktabs tables but "|" for normal tables.
toprule. Default is hline for normal table but toprule for booktabs tables.
bottomrule. Default is hline for normal table but bottomrule for booktabs tables.
midrule. Default is hline for normal table but midrule for booktabs tables.
By default, in booktabs tables,
kable insert an extra space
every five rows for clear display. If you don't want this feature or if you
want to do it in a different pattern, you can consider change this option.
The default is c('', '', '', '', '\addlinespace'). Also, if you are not
using booktabs, but you want a cleaner display, you can change this to ''.
Another latex feature. Short captions for tables
You probably don't need to change this as well. The default setting is to put a table environment outside of tabular if a caption is provided.
Other arguments (see Examples).