render_toc: Render Table of Contents

View source: R/table_of_content_markdown.R

render_tocR Documentation

Render Table of Contents

Description

From: https://gist.github.com/gadenbuie/c83e078bf8c81b035e32c3fc0cf04ee8

Usage

render_toc(
  filename,
  toc_header_name = "Table of Contents",
  base_level = NULL,
  toc_depth = 3
)

Arguments

filename

Name of RMarkdown or Markdown document

toc_header_name

The table of contents header name. If specified, any header with this format will not be included in the TOC. Set to NULL to include the TOC itself in the TOC (but why?).

base_level

Starting level of the lowest header level. Any headers prior to the first header at the base_level are dropped silently.

toc_depth

Maximum depth for TOC, relative to base_level. Default is toc_depth = 3, which results in a TOC of at most 3 levels.

Details

A simple function to extract headers from an RMarkdown or Markdown document and build a table of contents. Returns a markdown list with links to the headers using pandoc header identifiers.

WARNING: This function only works with hash-tag headers.

Because this function returns only the markdown list, the header for the Table of Contents itself must be manually included in the text. Use toc_header_name to exclude the table of contents header from the TOC, or set to NULL for it to be included.

Usage

Just drop in a chunk where you want the toc to appear (set echo=FALSE):

# Table of Contents

```{r echo=FALSE}
render_toc("/path/to/the/file.Rmd")
```

groupdata2 documentation built on July 9, 2023, 6:46 p.m.