diff --git a/.Rbuildignore b/.Rbuildignore
index 66e6bbc8..bbd71eb8 100644
--- a/.Rbuildignore
+++ b/.Rbuildignore
@@ -7,3 +7,6 @@
 ^scripts
 ^\.github$
 ^revdep$
+^_pkgdown\.yml$
+^docs$
+^pkgdown$
diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml
new file mode 100644
index 00000000..cd356765
--- /dev/null
+++ b/.github/workflows/pkgdown.yaml
@@ -0,0 +1,85 @@
+on:
+  push:
+    branches:
+      - master
+      - rc-**
+  pull_request:
+    branches: master
+
+name: pkgdown
+
+jobs:
+  pkgdown:
+    runs-on: ${{ matrix.config.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        config:
+          - {os: ubuntu-18.04,   r: 'release', rspm: "https://packagemanager.rstudio.com/cran/__linux__/bionic/latest"}
+    env:
+      RSPM: ${{ matrix.config.rspm }}
+      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
+    steps:
+      - uses: actions/checkout@v2
+
+      - uses: r-lib/actions/setup-r@master
+        id: install-r
+        with:
+          r-version: ${{ matrix.config.r }}
+
+      - uses: r-lib/actions/setup-pandoc@master
+
+      - name: Install pak and query dependencies
+        shell: Rscript {0}
+        run: |
+          install.packages("pak", repos = "https://r-lib.github.io/p/pak/dev/")
+          saveRDS(pak::pkg_deps_tree("local::.", dependencies = TRUE), ".github/r-depends.rds")
+      - name: Cache R packages
+        uses: actions/cache@v2
+        with:
+          path: ${{ env.R_LIBS_USER }}
+          key: ${{ matrix.config.os }}-${{ steps.install-r.outputs.installed-r-version }}-1-pkgdown-${{ hashFiles('.github/r-depends.rds') }}
+          restore-keys: |
+            ${{ matrix.config.os }}-${{ steps.install-r.outputs.installed-r-version }}-1-pkgdown-
+            ${{ matrix.config.os }}-${{ steps.install-r.outputs.installed-r-version }}-1-
+
+      - name: Install system dependencies
+        if: runner.os == 'Linux'
+        shell: Rscript {0}
+        run: |
+          pak::local_system_requirements(execute = TRUE)
+          pak::pkg_system_requirements("pkgdown", execute = TRUE)
+
+      - name: Install dependencies
+        shell: Rscript {0}
+        run: |
+          pak::local_install_dev_deps(upgrade = TRUE)
+          pak::pkg_install("pkgdown")
+
+      - name: Install package
+        run: R CMD INSTALL .
+
+      - name: Build Site (PR)
+        if: github.event_name != 'push'
+        shell: Rscript {0}
+        run: |
+          pkgdown::build_site(new_process = FALSE)
+      # Must validate after. Otherwise files are saved and `pkgdown::build_site()` gets mad
+      - name: Validate all topics exist (PR)
+        if: github.event_name != 'push'
+        shell: Rscript {0}
+        run: |
+          pkgdown::build_reference_index()
+          stopifnot(length(warnings()) == 0)
+
+      - name: Git Config
+        if: github.event_name == 'push'
+        run: |
+          git config --local user.email "${GITHUB_ACTOR}@users.noreply.github.com" && \
+            git config --local user.name "${GITHUB_ACTOR}"
+
+      - name: Build and Deploy Site
+        if: github.event_name == 'push'
+        shell: Rscript {0}
+        run: |
+          pkgdown::deploy_to_branch(new_process = FALSE)
diff --git a/.gitignore b/.gitignore
index 6af5fee0..190e5e23 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,3 +2,4 @@
 .Rhistory
 .RData
 .*.Rnb.cached
+docs
diff --git a/DESCRIPTION b/DESCRIPTION
index 26aa12cb..b42957d2 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: htmltools
 Type: Package
 Title: Tools for HTML
-Version: 0.5.1.9000
+Version: 0.5.1.9001
 Authors@R: c(
   person("Joe", "Cheng", role = "aut", email = "joe@rstudio.com"),
   person("Carson", "Sievert", role = c("aut", "cre"), email = "carson@rstudio.com", comment = c(ORCID = "0000-0002-4958-2844")),
@@ -49,3 +49,4 @@ Collate:
     'utils.R'
     'tags.R'
     'template.R'
+Roxygen: list(markdown = TRUE)
diff --git a/R/colors.R b/R/colors.R
index 47776687..aee1ac04 100644
--- a/R/colors.R
+++ b/R/colors.R
@@ -27,7 +27,6 @@
 #'   "hsl(261, 51%, 51%)",
 #'   "cornflowerblue"
 #' ))
-#' @md
 #' @export
 parseCssColors <- function(str, mustWork = TRUE) {
   # Logic below assumes a character string with non-missing values
diff --git a/R/html_dependency.R b/R/html_dependency.R
index 8eefd5e1..14b533aa 100644
--- a/R/html_dependency.R
+++ b/R/html_dependency.R
@@ -13,77 +13,77 @@
 #'   Details.
 #' @param meta Named list of meta tags to insert into document head
 #' @param script Script(s) to include within the document head (should be
-#'   specified relative to the \code{src} parameter).
+#'   specified relative to the `src` parameter).
 #' @param stylesheet Stylesheet(s) to include within the document (should be
-#'   specified relative to the \code{src} parameter).
+#'   specified relative to the `src` parameter).
 #' @param head Arbitrary lines of HTML to insert into the document head
 #' @param attachment Attachment(s) to include within the document head. See
 #'   Details.
-#' @param package An R package name to indicate where to find the \code{src}
-#'   directory when \code{src} is a relative path (see
-#'   \code{\link{resolveDependencies}}).
-#' @param all_files Whether all files under the \code{src} directory are
-#'   dependency files. If \code{FALSE}, only the files specified in
-#'   \code{script}, \code{stylesheet}, and \code{attachment} are treated as
+#' @param package An R package name to indicate where to find the `src`
+#'   directory when `src` is a relative path (see
+#'   [resolveDependencies()]).
+#' @param all_files Whether all files under the `src` directory are
+#'   dependency files. If `FALSE`, only the files specified in
+#'   `script`, `stylesheet`, and `attachment` are treated as
 #'   dependency files.
 #'
 #' @return An object that can be included in a list of dependencies passed to
-#'   \code{\link{attachDependencies}}.
+#'   [attachDependencies()].
 #'
 #' @details Each dependency can be located on the filesystem, at a relative or
 #'   absolute URL, or both. The location types are indicated using the names of
-#'   the \code{src} character vector: \code{file} for filesystem directory,
-#'   \code{href} for URL. For example, a dependency that was both on disk and at
-#'   a URL might use \code{src = c(file=filepath, href=url)}.
+#'   the `src` character vector: `file` for filesystem directory,
+#'   `href` for URL. For example, a dependency that was both on disk and at
+#'   a URL might use `src = c(file=filepath, href=url)`.
 #'
-#'   \code{script} can be given as one of the following:
+#'   `script` can be given as one of the following:
 #'   \itemize{
 #'   \item a character vector specifying various scripts to include relative to the
-#'     value of \code{src}.
-#'     Each is expanded into its own \code{<script>} tag
+#'     value of `src`.
+#'     Each is expanded into its own `<script>` tag
 #'   \item A named list with any of the following fields:
 #'   \itemize{
-#'     \item \code{src},
-#'     \item \code{integrity}, &
-#'     \item \code{crossorigin},
-#'     \item any other valid \code{<script>} attributes.
+#'     \item `src`,
+#'     \item `integrity`, &
+#'     \item `crossorigin`,
+#'     \item any other valid `<script>` attributes.
 #'     }
 #'     allowing the use of SRI to ensure the integrity of packages downloaded from
 #'     remote servers.
-#'     Eg: \code{script = list(src = "min.js", integrity = "hash")}
+#'     Eg: `script = list(src = "min.js", integrity = "hash")`
 #'   \item An unamed list, containing a combination of named list with the fields
 #'     mentioned previously, and strings.
 #'     Eg:
 #'     \itemize{
-#'     \item \code{script = list(list(src = "min.js"), "util.js", list(src = "log.js"))}
-#'     \item \code{script = "pkg.js"} is equivalent to
-#'     \item \code{script = list(src = "pkg.js")}.
+#'     \item `script = list(list(src = "min.js"), "util.js", list(src = "log.js"))`
+#'     \item `script = "pkg.js"` is equivalent to
+#'     \item `script = list(src = "pkg.js")`.
 #'     }
 #'   }
 #'
-#'   \code{attachment} can be used to make the indicated files available to the
-#'   JavaScript on the page via URL. For each element of \code{attachment}, an
-#'   element \code{<link id="DEPNAME-ATTACHINDEX-attachment" rel="attachment"
-#'   href="...">} is inserted, where \code{DEPNAME} is \code{name}. The value of
-#'   \code{ATTACHINDEX} depends on whether \code{attachment} is named or not; if
+#'   `attachment` can be used to make the indicated files available to the
+#'   JavaScript on the page via URL. For each element of `attachment`, an
+#'   element `<link id="DEPNAME-ATTACHINDEX-attachment" rel="attachment"
+#'   href="...">` is inserted, where `DEPNAME` is `name`. The value of
+#'   `ATTACHINDEX` depends on whether `attachment` is named or not; if
 #'   so, then it's the name of the element, and if not, it's the 1-based index
 #'   of the element. JavaScript can retrieve the URL using something like
-#'   \code{document.getElementById(depname + "-" + index + "-attachment").href}.
+#'   `document.getElementById(depname + "-" + index + "-attachment").href`.
 #'   Note that depending on the rendering context, the runtime value of the href
 #'   may be an absolute, relative, or data URI.
 #'
-#'   \code{htmlDependency} should not be called from the top-level of a package
+#'   `htmlDependency` should not be called from the top-level of a package
 #'   namespace with absolute paths (or with paths generated by
-#'   \code{system.file()}) and have the result stored in a variable. This is
-#'   because, when a binary package is built, R will run \code{htmlDependency}
+#'   `system.file()`) and have the result stored in a variable. This is
+#'   because, when a binary package is built, R will run `htmlDependency`
 #'   and store the path from the building machine's in the package. This path is
 #'   likely to differ from the correct path on a machine that downloads and
 #'   installs the binary package. If there are any absolute paths, instead of
-#'   calling \code{htmlDependency} at build-time, it should be called at
-#'   run-time. This can be done by wrapping the \code{htmlDependency} call in a
+#'   calling `htmlDependency` at build-time, it should be called at
+#'   run-time. This can be done by wrapping the `htmlDependency` call in a
 #'   function.
 #'
-#' @seealso Use \code{\link{attachDependencies}} to associate a list of
+#' @seealso Use [attachDependencies()] to associate a list of
 #'   dependencies with the HTML it belongs with.
 #'
 #' @export
@@ -144,14 +144,14 @@ validateScalarName <- function(x, name = deparse(substitute(x))) {
 #'
 #' Gets or sets the HTML dependencies associated with an object (such as a tag).
 #'
-#' \code{attachDependencies} provides an alternate syntax for setting
+#' `attachDependencies` provides an alternate syntax for setting
 #' dependencies. It is similar to \code{local(\{htmlDependencies(x) <- value;
 #' x\})}, except that if there are any existing dependencies,
-#' \code{attachDependencies} will add to them, instead of replacing them.
+#' `attachDependencies` will add to them, instead of replacing them.
 #'
 #' As of htmltools 0.3.4, HTML dependencies can be attached without using
-#' \code{attachDependencies}. Instead, they can be added inline, like a child
-#' object of a tag or \code{\link{tagList}}.
+#' `attachDependencies`. Instead, they can be added inline, like a child
+#' object of a tag or [tagList()].
 #'
 #' @param x An object which has (or should have) HTML dependencies.
 #' @param value An HTML dependency, or a list of HTML dependencies.
@@ -240,11 +240,11 @@ is_tag_function <- function(x) {
 #' HTML template.
 #'
 #' @param ... Names of the dependencies to suppress. For example,
-#'   \code{"jquery"} or \code{"bootstrap"}.
+#'   `"jquery"` or `"bootstrap"`.
 #'
-#' @seealso \code{\link{htmlTemplate}} for more information about using HTML
+#' @seealso [htmlTemplate()] for more information about using HTML
 #'   templates.
-#' @seealso \code{\link[htmltools]{htmlDependency}}
+#' @seealso [htmltools::htmlDependency()]
 #' @export
 suppressDependencies <- function(...) {
   lapply(dots_list(...), function(name) {
@@ -278,8 +278,8 @@ href_path <- function(dependency) {
 #' Encode a URL path
 #'
 #' Encode characters in a URL path. This is the same as
-#' \code{\link[utils]{URLencode}} with \code{reserved = TRUE} except that
-#' \code{/} is preserved.
+#' [utils::URLencode()] with `reserved = TRUE` except that
+#' `/` is preserved.
 #'
 #' @param x A character vector.
 #' @export
@@ -291,9 +291,9 @@ urlEncodePath <- function(x) {
 #' Copy an HTML dependency to a directory
 #'
 #' Copies an HTML dependency to a subdirectory of the given directory. The
-#' subdirectory name will be \emph{name}-\emph{version} (for example,
-#' "outputDir/jquery-1.11.0"). You may set \code{options(htmltools.dir.version =
-#' FALSE)} to suppress the version number in the subdirectory name.
+#' subdirectory name will be *name*-*version* (for example,
+#' "outputDir/jquery-1.11.0"). You may set `options(htmltools.dir.version =
+#' FALSE)` to suppress the version number in the subdirectory name.
 #'
 #' In order for disk-based dependencies to work with static HTML files, it's
 #' generally necessary to copy them to either the directory of the referencing
@@ -303,14 +303,14 @@ urlEncodePath <- function(x) {
 #' @param dependency A single HTML dependency object.
 #' @param outputDir The directory in which a subdirectory should be created for
 #'   this dependency.
-#' @param mustWork If \code{TRUE} and \code{dependency} does not point to a
+#' @param mustWork If `TRUE` and `dependency` does not point to a
 #'   directory on disk (but rather a URL location), an error is raised. If
-#'   \code{FALSE} then non-disk dependencies are returned without modification.
+#'   `FALSE` then non-disk dependencies are returned without modification.
 #'
-#' @return The dependency with its \code{src} value updated to the new
+#' @return The dependency with its `src` value updated to the new
 #'   location's absolute path.
 #'
-#' @seealso \code{\link{makeDependencyRelative}} can be used with the returned
+#' @seealso [makeDependencyRelative()] can be used with the returned
 #'   value to make the path relative to a specific directory.
 #'
 #' @export
@@ -408,19 +408,19 @@ relativeTo <- function(dir, file) {
 #' directories.
 #'
 #' @param dependency A single HTML dependency with an absolute path.
-#' @param basepath The path to the directory that \code{dependency} should be
+#' @param basepath The path to the directory that `dependency` should be
 #'   made relative to.
-#' @param mustWork If \code{TRUE} and \code{dependency} does not point to a
+#' @param mustWork If `TRUE` and `dependency` does not point to a
 #'   directory on disk (but rather a URL location), an error is raised. If
-#'   \code{FALSE} then non-disk dependencies are returned without modification.
+#'   `FALSE` then non-disk dependencies are returned without modification.
 #'
-#' @return The dependency with its \code{src} value updated to the new
+#' @return The dependency with its `src` value updated to the new
 #' location's relative path.
 #'
-#' If \code{baspath} did not appear to be a parent directory of the dependency's
-#' directory, an error is raised (regardless of the value of \code{mustWork}).
+#' If `baspath` did not appear to be a parent directory of the dependency's
+#' directory, an error is raised (regardless of the value of `mustWork`).
 #'
-#' @seealso \code{\link{copyDependencyToDir}}
+#' @seealso [copyDependencyToDir()]
 #'
 #' @export
 makeDependencyRelative <- function(dependency, basepath, mustWork = TRUE) {
@@ -444,15 +444,15 @@ makeDependencyRelative <- function(dependency, basepath, mustWork = TRUE) {
 #' Create the appropriate HTML markup for including dependencies in an HTML
 #' document.
 #'
-#' @param dependencies A list of \code{htmlDependency} objects.
-#' @param srcType The type of src paths to use; valid values are \code{file} or
-#'   \code{href}.
+#' @param dependencies A list of `htmlDependency` objects.
+#' @param srcType The type of src paths to use; valid values are `file` or
+#'   `href`.
 #' @param encodeFunc The function to use to encode the path part of a URL. The
 #'   default should generally be used.
 #' @param hrefFilter A function used to transform the final, encoded URLs of
 #'   script and stylesheet files. The default should generally be used.
 #'
-#' @return An \code{\link{HTML}} object suitable for inclusion in the head of an
+#' @return An [HTML()] object suitable for inclusion in the head of an
 #'   HTML document.
 #'
 #' @export
diff --git a/R/html_print.R b/R/html_print.R
index 4fcb0ba9..c257514f 100644
--- a/R/html_print.R
+++ b/R/html_print.R
@@ -1,15 +1,15 @@
 #' Make an HTML object browsable
 #'
 #' By default, HTML objects display their HTML markup at the console when
-#' printed. \code{browsable} can be used to make specific objects render as HTML
+#' printed. `browsable` can be used to make specific objects render as HTML
 #' by default when printed at the console.
 #'
 #' You can override the default browsability of an HTML object by explicitly
-#' passing \code{browse = TRUE} (or \code{FALSE}) to the \code{print} function.
+#' passing `browse = TRUE` (or `FALSE`) to the `print` function.
 #'
 #' @param x The object to make browsable or not.
 #' @param value Whether the object should be considered browsable.
-#' @return \code{browsable} returns \code{x} with an extra attribute to indicate
+#' @return `browsable` returns `x` with an extra attribute to indicate
 #'   that the value is browsable.
 #' @export
 browsable <- function(x, value = TRUE) {
@@ -17,8 +17,8 @@ browsable <- function(x, value = TRUE) {
   return(x)
 }
 
-#' @return \code{is.browsable} returns \code{TRUE} if the value is browsable, or
-#'   \code{FALSE} if not.
+#' @return `is.browsable` returns `TRUE` if the value is browsable, or
+#'   `FALSE` if not.
 #' @rdname browsable
 #' @export
 is.browsable <- function(x) {
@@ -28,12 +28,12 @@ is.browsable <- function(x) {
 #' Implementation of the print method for HTML
 #'
 #' Convenience method that provides an implementation of the
-#' \code{\link[base:print]{print}} method for HTML content.
+#' [base::print()] method for HTML content.
 #'
 #' @param html HTML content to print
 #' @param background Background color for web page
 #' @param viewer A function to be called with the URL or path to the generated
-#'   HTML page. Can be \code{NULL}, in which case no viewer will be invoked.
+#'   HTML page. Can be `NULL`, in which case no viewer will be invoked.
 #'
 #' @return Invisibly returns the URL or path of the generated HTML page.
 #'
@@ -60,7 +60,7 @@ html_print <- function(html, background = "white", viewer = getOption("viewer",
 #' Save an HTML object to a file
 #'
 #' Save the specified HTML object to a file, copying all of it's
-#' dependencies to the directory specified via \code{libdir}.
+#' dependencies to the directory specified via `libdir`.
 #'
 #' @param html HTML content to print
 #' @param background Background color for web page
diff --git a/R/images.R b/R/images.R
index b3f86ee7..8007c809 100644
--- a/R/images.R
+++ b/R/images.R
@@ -17,7 +17,6 @@
 #' @seealso [plotTag()] saves plots as a self-contained `<img>`
 #'   tag.
 #'
-#' @md
 #' @examples
 #'
 #' # Default settings
@@ -133,7 +132,6 @@ capturePlot <- function(expr, filename = tempfile(fileext = ".png"),
 #'
 #' @seealso [capturePlot()] saves plots as an image file.
 #'
-#' @md
 #' @examples
 #'
 #' img <- plotTag({
@@ -191,7 +189,6 @@ plotTag <- function(expr, alt, device = defaultPngDevice(), width = 400, height
 #'
 #' @return A graphics device function.
 #'
-#' @md
 #' @export
 defaultPngDevice <- function() {
   if (capabilities("aqua")) {
diff --git a/R/tag_query.R b/R/tag_query.R
index 3451f96a..feaec290 100644
--- a/R/tag_query.R
+++ b/R/tag_query.R
@@ -390,7 +390,7 @@ as.character.htmltools.tag.query <- function(x, ...) {
 
 
 
-#' Tag Query - Perform jQuery-like alterations on tag objects
+#' Perform jQuery-like alterations on tags
 #'
 #' `r lifecycle::badge("experimental")`
 #'
@@ -497,7 +497,6 @@ as.character.htmltools.tag.query <- function(x, ...) {
 #'   `root` object. At the time of initialization, the `root` is also considered
 #'   the single selected item. If any selections are made, the selected elements
 #'   will be updated.
-#' @md
 #' @export
 tagQuery <- function(tags) {
 
@@ -552,7 +551,6 @@ tagQuery <- function(tags) {
 #' @rdname tagQuery
 #' @aliases NULL
 #' @usage NULL
-#' @md
 tagQuery_ <- function(
   root,
   # Using a trailing `_` to avoid name collisions
diff --git a/R/tags.R b/R/tags.R
index b5ba83e3..c0f25572 100644
--- a/R/tags.R
+++ b/R/tags.R
@@ -72,11 +72,11 @@ depListToNamedDepList <- function(dependencies) {
 #' name equality). If multiple versions of a dependency are found, the copy with
 #' the latest version number is used.
 #'
-#' @param dependencies A list of \code{\link{htmlDependency}} objects.
+#' @param dependencies A list of [htmlDependency()] objects.
 #' @param resolvePackageDir Whether to resolve the relative path to an absolute
-#'   path via \code{\link{system.file}} when the \code{package} attribute is
+#'   path via [system.file()] when the `package` attribute is
 #'   present in a dependency object.
-#' @return dependencies A list of \code{\link{htmlDependency}} objects with
+#' @return dependencies A list of [htmlDependency()] objects with
 #'   redundancies removed.
 #'
 #' @export
@@ -119,18 +119,18 @@ resolveDependencies <- function(dependencies, resolvePackageDir = TRUE) {
 #' dependency being removed is later than the version of the dependency object
 #' that is causing the removal.
 #'
-#' @param dependencies A list of \code{\link{htmlDependency}} objects from which
+#' @param dependencies A list of [htmlDependency()] objects from which
 #'   dependencies should be removed.
-#' @param remove A list of \code{\link{htmlDependency}} objects indicating which
+#' @param remove A list of [htmlDependency()] objects indicating which
 #'   dependencies should be removed, or a character vector indicating dependency
 #'   names.
-#' @param warnOnConflict If \code{TRUE}, a warning is emitted for each
-#'   dependency that is removed if the corresponding dependency in \code{remove}
-#'   has a lower version number. Has no effect if \code{remove} is provided as a
+#' @param warnOnConflict If `TRUE`, a warning is emitted for each
+#'   dependency that is removed if the corresponding dependency in `remove`
+#'   has a lower version number. Has no effect if `remove` is provided as a
 #'   character vector.
 #'
-#' @return A list of \code{\link{htmlDependency}} objects that don't intersect
-#'   with \code{remove}.
+#' @return A list of [htmlDependency()] objects that don't intersect
+#'   with `remove`.
 #'
 #' @export
 subtractDependencies <- function(dependencies, remove, warnOnConflict = TRUE) {
@@ -221,9 +221,9 @@ as.character.shiny.tag.list <- as.character.shiny.tag
 #' browser.
 #'
 #' @param x The value to print.
-#' @param browse If \code{TRUE}, the HTML will be rendered and displayed in a
+#' @param browse If `TRUE`, the HTML will be rendered and displayed in a
 #'   browser (or possibly another HTML viewer supplied by the environment via
-#'   the \code{viewer} option). If \code{FALSE} then the HTML object's markup
+#'   the `viewer` option). If `FALSE` then the HTML object's markup
 #'   will be rendered at the console.
 #' @param ... Additional arguments passed to print.
 #'
@@ -362,29 +362,29 @@ throw_if_tag_function <- function(tag) {
 
 #' HTML Tag Object
 #'
-#' \code{tag()} creates an HTML tag definition. Note that all of the valid HTML5
-#' tags are already defined in the \code{\link{tags}} environment so these
+#' `tag()` creates an HTML tag definition. Note that all of the valid HTML5
+#' tags are already defined in the [tags()] environment so these
 #' functions should only be used to generate additional tags.
-#' \code{tagAppendChild()} and \code{tagList()} are for supporting package
+#' `tagAppendChild()` and `tagList()` are for supporting package
 #' authors who wish to create their own sets of tags; see the contents of
 #' bootstrap.R for examples.
 #' @param _tag_name HTML tag name
 #' @param varArgs List of attributes and children of the element. Named list
 #'   items become attributes, and unnamed list items become children. Valid
 #'   children are tags, single-character character vectors (which become text
-#'   nodes), and raw HTML (see \code{\link{HTML}}). You can also pass lists that
+#'   nodes), and raw HTML (see [HTML()]). You can also pass lists that
 #'   contain tags, text nodes, and HTML.
 #' @param tag A tag to append child elements to.
 #' @param child A child element to append to a parent tag.
 #' @param ...  Unnamed items that comprise this list of tags.
 #' @param list An optional list of elements. Can be used with or instead of the
-#'   \code{...} items.
+#'   `...` items.
 #' @param .noWS Character vector used to omit some of the whitespace that would
-#'   normally be written around this tag. Valid options include \code{before},
-#'   \code{after}, \code{outside}, \code{after-begin}, and \code{before-end}.
+#'   normally be written around this tag. Valid options include `before`,
+#'   `after`, `outside`, `after-begin`, and `before-end`.
 #'   Any number of these options can be specified.
 #' @return An HTML tag object that can be rendered as HTML using
-#'   \code{\link{as.character}()}.
+#'   [as.character()].
 #' @export
 #' @examples
 #' tagList(tags$h1("Title"),
@@ -548,29 +548,29 @@ tagWrite <- function(tag, textWriter, indent=0, eol = "\n") {
 #' Render tags into HTML
 #'
 #' Renders tags (and objects that can be converted into tags using
-#' \code{\link{as.tags}}) into HTML. (Generally intended to be called from web
+#' [as.tags()]) into HTML. (Generally intended to be called from web
 #' framework libraries, not directly by most users--see
-#' \code{\link{print.html}(browse=TRUE)} for higher level rendering.)
+#' `[print.html](browse=TRUE)` for higher level rendering.)
 #'
 #' @param x Tag object(s) to render
-#' @param singletons A list of \link{singleton} signatures to consider already
+#' @param singletons A list of [singleton] signatures to consider already
 #'   rendered; any matching singletons will be dropped instead of rendered.
 #'   (This is useful (only?) for incremental rendering.)
-#' @param indent Initial indent level, or \code{FALSE} if no indentation should
+#' @param indent Initial indent level, or `FALSE` if no indentation should
 #'   be used.
 #'
-#' @return \code{renderTags} returns a list with the following variables:
+#' @return `renderTags` returns a list with the following variables:
 #' \describe{
-#'   \item{\code{head}}{An \code{\link{HTML}} string that should be included in
-#'     \code{<head>}.
+#'   \item{`head`}{An [HTML()] string that should be included in
+#'     `<head>`.
 #'   }
-#'   \item{\code{singletons}}{Character vector of singleton signatures that are
+#'   \item{`singletons`}{Character vector of singleton signatures that are
 #'     known after rendering.
 #'   }
-#'   \item{\code{dependencies}}{A list of \link[=resolveDependencies]{resolved}
-#'     \code{\link{htmlDependency}} objects.
+#'   \item{`dependencies`}{A list of [resolved][resolveDependencies]
+#'     [htmlDependency()] objects.
 #'   }
-#'   \item{\code{html}}{An \code{\link{HTML}} string that represents the main
+#'   \item{`html`}{An [HTML()] string that represents the main
 #'     HTML that was rendered.
 #'   }
 #' }
@@ -593,10 +593,10 @@ renderTags <- function(x, singletons = character(0), indent = 0) {
     html = bodyHtml))
 }
 
-#' @details \code{doRenderTags} is intended for very low-level use; it ignores
+#' @details `doRenderTags` is intended for very low-level use; it ignores
 #'   singleton, head, and dependency handling, and simply renders the given tag
 #'   objects as HTML.
-#' @return \code{doRenderTags} returns a simple \code{\link{HTML}} string.
+#' @return `doRenderTags` returns a simple [HTML()] string.
 #' @rdname renderTags
 #' @export
 doRenderTags <- function(x, indent = 0) {
@@ -632,16 +632,16 @@ rewriteTags <- function(ui, func, preorder) {
 
 #' Singleton manipulation functions
 #'
-#' Functions for manipulating \code{\link{singleton}} objects in tag
+#' Functions for manipulating [singleton()] objects in tag
 #' hierarchies. Intended for framework authors.
 #'
 #' @rdname singleton_tools
 #' @name singleton_tools
 NULL
 
-#' @param ui Tag object or lists of tag objects. See \link{builder} topic.
-#' @return \code{surroundSingletons} preprocesses a tag object by changing any
-#'   singleton X into <!--SHINY.SINGLETON[sig]-->X'<!--/SHINY.SINGLETON[sig]-->
+#' @param ui Tag object or lists of tag objects. See [builder] topic.
+#' @return `surroundSingletons` preprocesses a tag object by changing any
+#'   singleton X into `<!--SHINY.SINGLETON[sig]-->X'<!--/SHINY.SINGLETON[sig]-->`
 #'   where sig is the sha1 of X, and X' is X minus the singleton attribute.
 #' @rdname singleton_tools
 #' @export
@@ -671,12 +671,12 @@ surroundSingletons <- local({
 
 #' @param singletons Character vector of singleton signatures that have already
 #'   been encountered (i.e. returned from previous calls to
-#'   \code{takeSingletons}).
+#'   `takeSingletons`).
 #' @param desingleton Logical value indicating whether singletons that are
 #'   encountered should have the singleton attribute removed.
-#' @return \code{takeSingletons} returns a list with the elements \code{ui} (the
+#' @return `takeSingletons` returns a list with the elements `ui` (the
 #'   processed tag objects with any duplicate singleton objects removed) and
-#'   \code{singletons} (the list of known singleton signatures).
+#'   `singletons` (the list of known singleton signatures).
 #' @rdname singleton_tools
 #' @export
 takeSingletons <- function(ui, singletons=character(0), desingleton=TRUE) {
@@ -719,7 +719,7 @@ takeHeads <- function(ui) {
 #' @param tags A tag-like object to search for dependencies.
 #' @param tagify Whether to tagify the input before searching for dependencies.
 #'
-#' @return A list of \code{\link{htmlDependency}} objects.
+#' @return A list of [htmlDependency()] objects.
 #'
 #' @export
 findDependencies <- function(tags, tagify = TRUE) {
@@ -769,31 +769,31 @@ resolveFunctionalDependencies <- function(dependencies) {
 #'
 #' Simple functions for constructing HTML documents.
 #'
-#' The \code{tags} environment contains convenience functions for all valid
+#' The `tags` environment contains convenience functions for all valid
 #' HTML5 tags. To generate tags that are not part of the HTML5 specification,
-#' you can use the \code{\link{tag}()} function.
+#' you can use the [tag()] function.
 #'
 #' Dedicated functions are available for the most common HTML tags that do not
 #' conflict with common R functions.
 #'
 #' The result from these functions is a tag object, which can be converted using
-#' \code{\link{as.character}()}.
+#' [as.character()].
 #'
 #' @name builder
 #' @param ... Attributes and children of the element. Named arguments become
 #'   attributes, and positional arguments become children. Valid children are
 #'   tags, single-character character vectors (which become text nodes), raw
-#'   HTML (see \code{\link{HTML}}), and \code{html_dependency} objects. You can
+#'   HTML (see [HTML()]), and `html_dependency` objects. You can
 #'   also pass lists that contain tags, text nodes, or HTML. To use boolean
-#'   attributes, use a named argument with a \code{NA} value. (see example)
+#'   attributes, use a named argument with a `NA` value. (see example)
 #' @param .noWS A character vector used to omit some of the whitespace that
 #'   would normally be written around this tag. Valid options include
-#'   \code{before}, \code{after}, \code{outside}, \code{after-begin},
-#'   \code{before-end}, and \code{inside}. Any number of these options can be
+#'   `before`, `after`, `outside`, `after-begin`,
+#'   `before-end`, and `inside`. Any number of these options can be
 #'   specified.
 #' @references \itemize{
 #'    \item W3C html specification about boolean attributes
-#'    \url{https://www.w3.org/TR/html5/infrastructure.html#sec-boolean-attributes}
+#'    <https://www.w3.org/TR/html5/infrastructure.html#sec-boolean-attributes>
 #'  }
 #' @export tags
 #' @examples
@@ -856,16 +856,16 @@ rm(known_tags)
 
 #' Mark Characters as HTML
 #'
-#' Marks the given text as HTML, which means the \link{tag} functions will know
+#' Marks the given text as HTML, which means the [tag] functions will know
 #' not to perform HTML escaping on it.
 #'
 #' @param text The text value to mark with HTML
 #' @param ... Any additional values to be converted to character and
 #'   concatenated together
 #' @param .noWS Character vector used to omit some of the whitespace that would
-#'   normally be written around this HTML. Valid options include \code{before},
-#'   \code{after}, and \code{outside} (equivalent to \code{before} and
-#'   \code{end}).
+#'   normally be written around this HTML. Valid options include `before`,
+#'   `after`, and `outside` (equivalent to `before` and
+#'   `end`).
 #' @return The same value, but marked as HTML.
 #'
 #' @examples
@@ -882,18 +882,18 @@ HTML <- function(text, ..., .noWS = NULL) {
   htmlText
 }
 
-#' Evaluate an expression using \code{tags}
+#' Evaluate an expression using `tags`
 #'
 #' This function makes it simpler to write HTML-generating code. Instead of
-#' needing to specify \code{tags} each time a tag function is used, as in
-#' \code{tags$div()} and \code{tags$p()}, code inside \code{withTags} is
-#' evaluated with \code{tags} searched first, so you can simply use
-#' \code{div()} and \code{p()}.
+#' needing to specify `tags` each time a tag function is used, as in
+#' `tags$div()` and `tags$p()`, code inside `withTags` is
+#' evaluated with `tags` searched first, so you can simply use
+#' `div()` and `p()`.
 #'
 #' If your code uses an object which happens to have the same name as an
-#' HTML tag function, such as \code{source()} or \code{summary()}, it will call
+#' HTML tag function, such as `source()` or `summary()`, it will call
 #' the tag function. To call the intended (non-tags function), specify the
-#' namespace, as in \code{base::source()} or \code{base::summary()}.
+#' namespace, as in `base::source()` or `base::summary()`.
 #'
 #' @param code A set of tags.
 #'
@@ -1005,8 +1005,8 @@ flattenTagAttribs <- function(attribs) {
 #' Convert a value to tags
 #'
 #' An S3 method for converting arbitrary values to a value that can be used as
-#' the child of a tag or \code{tagList}. The default implementation simply calls
-#' \code{\link{as.character}}.
+#' the child of a tag or `tagList`. The default implementation simply calls
+#' [as.character()].
 #'
 #' @param x Object to be converted.
 #' @param ... Any additional parameters.
@@ -1075,7 +1075,7 @@ as.tags.html_dependency <- function(x, ...) {
 #' Text processing tools like markdown and pandoc are designed to turn
 #' human-friendly markup into common output formats like HTML. This works well
 #' for most prose, but components that generate their own HTML may break if
-#' their markup is interpreted as the input language. The \code{htmlPreserve}
+#' their markup is interpreted as the input language. The `htmlPreserve`
 #' function is used to mark regions of an input document as containing pure HTML
 #' that must not be modified. This is achieved by substituting each such region
 #' with a benign but unique string before processing, and undoing those
@@ -1083,7 +1083,7 @@ as.tags.html_dependency <- function(x, ...) {
 #'
 #' @param x A character vector of HTML to be preserved.
 #'
-#' @return \code{htmlPreserve} returns a single-element character vector with
+#' @return `htmlPreserve` returns a single-element character vector with
 #'   "magic" HTML comments surrounding the original text (unless the original
 #'   text was empty, in which case an empty string is returned).
 #'
@@ -1172,8 +1172,8 @@ withPrivateSeed <- local({
 # and any inner regions simply have their boundaries removed before the values
 # are stashed in $chunks.
 
-#' @return \code{extractPreserveChunks} returns a list with two named elements:
-#'   \code{value} is the string with the regions replaced, and \code{chunks} is
+#' @return `extractPreserveChunks` returns a list with two named elements:
+#'   `value` is the string with the regions replaced, and `chunks` is
 #'   a named character vector where the names are the IDs and the values are the
 #'   regions that were extracted.
 #' @rdname htmlPreserve
@@ -1263,9 +1263,9 @@ extractPreserveChunks <- function(strval) {
 }
 
 #' @param strval Input string from which to extract/restore chunks.
-#' @param chunks The \code{chunks} element of the return value of
-#'   \code{extractPreserveChunks}.
-#' @return \code{restorePreserveChunks} returns a character vector with the
+#' @param chunks The `chunks` element of the return value of
+#'   `extractPreserveChunks`.
+#' @return `restorePreserveChunks` returns a character vector with the
 #'   chunk IDs replaced with their original values.
 #' @rdname htmlPreserve
 #' @export
@@ -1410,11 +1410,11 @@ includeHTML <- function(path) {
   return(HTML(paste8(lines, collapse='\n')))
 }
 
-#' @note \code{includeText} escapes its contents, but does no other processing.
+#' @note `includeText` escapes its contents, but does no other processing.
 #'   This means that hard breaks and multiple spaces will be rendered as they
 #'   usually are in HTML: as a single space character. If you are looking for
-#'   preformatted text, wrap the call with \code{\link{pre}}, or consider using
-#'   \code{includeMarkdown} instead.
+#'   preformatted text, wrap the call with [pre()], or consider using
+#'   `includeMarkdown` instead.
 #'
 #' @rdname include
 #' @export
@@ -1423,7 +1423,7 @@ includeText <- function(path) {
   return(paste8(lines, collapse='\n'))
 }
 
-#' @note The \code{includeMarkdown} function requires the \code{markdown}
+#' @note The `includeMarkdown` function requires the `markdown`
 #'   package.
 #' @rdname include
 #' @export
@@ -1454,12 +1454,12 @@ includeScript <- function(path, ...) {
 
 #' Include content only once
 #'
-#' Use \code{singleton} to wrap contents (tag, text, HTML, or lists) that should
+#' Use `singleton` to wrap contents (tag, text, HTML, or lists) that should
 #' be included in the generated document only once, yet may appear in the
 #' document-generating code more than once. Only the first appearance of the
 #' content (in document order) will be used.
 #'
-#' @param x A \code{\link{tag}}, text, \code{\link{HTML}}, or list.
+#' @param x A [tag()], text, [HTML()], or list.
 #' @param value Whether the object should be a singleton.
 #'
 #' @export
@@ -1479,18 +1479,18 @@ is.singleton <- function(x) {
 #'
 #' Checks that the argument is valid for use as a CSS unit of length.
 #'
-#' \code{NULL} and \code{NA} are returned unchanged.
+#' `NULL` and `NA` are returned unchanged.
 #'
 #' Single element numeric vectors are returned as a character vector with the
-#' number plus a suffix of \code{"px"}.
+#' number plus a suffix of `"px"`.
 #'
-#' Single element character vectors must be \code{"auto"}, \code{"fit-content"}
-#' or \code{"inherit"}, a number, or a length calculated by the \code{"calc"}
-#' CSS function. If the number has a suffix, it must be valid: \code{px},
-#' \code{\%}, \code{ch}, \code{em}, \code{rem}, \code{pt}, \code{in}, \code{cm},
-#' \code{mm}, \code{ex}, \code{pc}, \code{vh}, \code{vw}, \code{vmin}, or
-#' \code{vmax}.
-#' If the number has no suffix, the suffix \code{"px"} is appended.
+#' Single element character vectors must be `"auto"`, `"fit-content"`
+#' or `"inherit"`, a number, or a length calculated by the `"calc"`
+#' CSS function. If the number has a suffix, it must be valid: `px`,
+#' `\%`, `ch`, `em`, `rem`, `pt`, `in`, `cm`,
+#' `mm`, `ex`, `pc`, `vh`, `vw`, `vmin`, or
+#' `vmax`.
+#' If the number has no suffix, the suffix `"px"` is appended.
 #'
 #'
 #' Any other value will cause an error to be thrown.
@@ -1533,27 +1533,27 @@ validateCssUnit <- function(x) {
 #' that goes into a style attribute, or the parts that go inside curly braces in
 #' a full stylesheet).
 #'
-#' CSS uses \code{'-'} (minus) as a separator character in property names, but
+#' CSS uses `'-'` (minus) as a separator character in property names, but
 #' this is an inconvenient character to use in an R function argument name.
-#' Instead, you can use \code{'.'} (period) and/or \code{'_'} (underscore) as
-#' separator characters. For example, \code{css(font.size = "12px")} yields
-#' \code{"font-size:12px;"}.
+#' Instead, you can use `'.'` (period) and/or `'_'` (underscore) as
+#' separator characters. For example, `css(font.size = "12px")` yields
+#' `"font-size:12px;"`.
 #'
-#' To mark a property as \code{!important}, add a \code{'!'} character to the end
-#' of the property name. (Since \code{'!'} is not normally a character that can be
+#' To mark a property as `!important`, add a `'!'` character to the end
+#' of the property name. (Since `'!'` is not normally a character that can be
 #' used in an identifier in R, you'll need to put the name in double quotes or
 #' backticks.)
 #'
 #' Argument values will be converted to strings using
-#' \code{paste(collapse = " ")}. Any property with a value of \code{NULL} or
-#' \code{""} (after paste) will be dropped.
+#' `paste(collapse = " ")`. Any property with a value of `NULL` or
+#' `""` (after paste) will be dropped.
 #'
 #' @param ... Named style properties, where the name is the property name and
 #'   the argument is the property value. See Details for conversion rules.
 #' @param collapse_ (Note that the parameter name has a trailing underscore
 #'   character.) Character to use to collapse properties into a single string;
-#'   likely \code{""} (the default) for style attributes, and either \code{"\n"}
-#'   or \code{NULL} for style blocks.
+#'   likely `""` (the default) for style attributes, and either `"\n"`
+#'   or `NULL` for style blocks.
 #'
 #' @examples
 #' padding <- 6
diff --git a/R/template.R b/R/template.R
index e24874cc..78989121 100644
--- a/R/template.R
+++ b/R/template.R
@@ -2,20 +2,20 @@
 #'
 #' Process an HTML template and return a tagList object. If the template is a
 #' complete HTML document, then the returned object will also have class
-#' \code{html_document}, and can be passed to the function
-#' \code{\link{renderDocument}} to get the final HTML text.
+#' `html_document`, and can be passed to the function
+#' [renderDocument()] to get the final HTML text.
 #'
 #' @param filename Path to an HTML template file. Incompatible with
-#'   \code{text_}.
+#'   `text_`.
 #' @param ... Variable values to use when processing the template.
 #' @param text_ A string to use as the template, instead of a file. Incompatible
-#'   with \code{filename}.
-#' @param document_ Is this template a complete HTML document (\code{TRUE}), or
+#'   with `filename`.
+#' @param document_ Is this template a complete HTML document (`TRUE`), or
 #'   a fragment of HTML that is to be inserted into an HTML document
-#'   (\code{FALSE})? With \code{"auto"} (the default), auto-detect by searching
-#'   for the string \code{"<HTML>"} within the template.
+#'   (`FALSE`)? With `"auto"` (the default), auto-detect by searching
+#'   for the string `"<HTML>"` within the template.
 #'
-#' @seealso \code{\link{renderDocument}}
+#' @seealso [renderDocument()]
 #' @export
 #' @useDynLib htmltools, .registration = TRUE
 htmlTemplate <- function(filename = NULL, ..., text_ = NULL, document_ = "auto") {
@@ -75,26 +75,26 @@ htmlTemplate <- function(filename = NULL, ..., text_ = NULL, document_ = "auto")
 
 #' Render an html_document object
 #'
-#' This function renders \code{html_document} objects, and returns a string with
-#' the final HTML content. It calls the \code{\link{renderTags}} function to
+#' This function renders `html_document` objects, and returns a string with
+#' the final HTML content. It calls the [renderTags()] function to
 #' convert any shiny.tag objects to HTML. It also finds any any web dependencies
-#' (created by \code{\link{htmlDependency}}) that are attached to the tags, and
+#' (created by [htmlDependency()]) that are attached to the tags, and
 #' inserts those. To do the insertion, this function finds the string
-#' \code{"<!-- HEAD_CONTENT -->"} in the document, and replaces it with the web
+#' `"<!-- HEAD_CONTENT -->"` in the document, and replaces it with the web
 #' dependencies.
 #'
-#' @param x An object of class \code{html_document}, typically generated by the
-#'   \code{\link{htmlTemplate}} function.
+#' @param x An object of class `html_document`, typically generated by the
+#'   [htmlTemplate()] function.
 #' @param deps Any extra web dependencies to add to the html document. This can
-#'   be an object created by \code{\link{htmlDependency}}, or a list of such
+#'   be an object created by [htmlDependency()], or a list of such
 #'   objects. These dependencies will be added first, before other dependencies.
 #' @param processDep A function that takes a "raw" html_dependency object and
-#'   does further processing on it. For example, when \code{renderDocument} is
-#'   called from Shiny, the function \code{\link[shiny]{createWebDependency}} is
+#'   does further processing on it. For example, when `renderDocument` is
+#'   called from Shiny, the function [shiny::createWebDependency()] is
 #'   used; it modifies the href and tells Shiny to serve a particular path on
 #'   the filesystem.
 #'
-#' @return An \code{\link{HTML}} string, with UTF-8 encoding.
+#' @return An [HTML()] string, with UTF-8 encoding.
 #'
 #' @export
 renderDocument <- function(x, deps = NULL, processDep = identity) {
diff --git a/man/as.tags.Rd b/man/as.tags.Rd
index 819d06eb..4b3949a2 100644
--- a/man/as.tags.Rd
+++ b/man/as.tags.Rd
@@ -14,5 +14,5 @@ as.tags(x, ...)
 \description{
 An S3 method for converting arbitrary values to a value that can be used as
 the child of a tag or \code{tagList}. The default implementation simply calls
-\code{\link{as.character}}.
+\code{\link[=as.character]{as.character()}}.
 }
diff --git a/man/browsable.Rd b/man/browsable.Rd
index b2d186ed..736f72cc 100644
--- a/man/browsable.Rd
+++ b/man/browsable.Rd
@@ -16,10 +16,10 @@ is.browsable(x)
 }
 \value{
 \code{browsable} returns \code{x} with an extra attribute to indicate
-  that the value is browsable.
+that the value is browsable.
 
 \code{is.browsable} returns \code{TRUE} if the value is browsable, or
-  \code{FALSE} if not.
+\code{FALSE} if not.
 }
 \description{
 By default, HTML objects display their HTML markup at the console when
diff --git a/man/builder.Rd b/man/builder.Rd
index 85c01f45..46a61b6e 100644
--- a/man/builder.Rd
+++ b/man/builder.Rd
@@ -62,7 +62,7 @@ hr(..., .noWS = NULL)
 \item{...}{Attributes and children of the element. Named arguments become
 attributes, and positional arguments become children. Valid children are
 tags, single-character character vectors (which become text nodes), raw
-HTML (see \code{\link{HTML}}), and \code{html_dependency} objects. You can
+HTML (see \code{\link[=HTML]{HTML()}}), and \code{html_dependency} objects. You can
 also pass lists that contain tags, text nodes, or HTML. To use boolean
 attributes, use a named argument with a \code{NA} value. (see example)}
 
@@ -78,13 +78,13 @@ Simple functions for constructing HTML documents.
 \details{
 The \code{tags} environment contains convenience functions for all valid
 HTML5 tags. To generate tags that are not part of the HTML5 specification,
-you can use the \code{\link{tag}()} function.
+you can use the \code{\link[=tag]{tag()}} function.
 
 Dedicated functions are available for the most common HTML tags that do not
 conflict with common R functions.
 
 The result from these functions is a tag object, which can be converted using
-\code{\link{as.character}()}.
+\code{\link[=as.character]{as.character()}}.
 }
 \examples{
 doc <- tags$html(
@@ -121,7 +121,7 @@ cat(as.character(oneline))
 }
 \references{
 \itemize{
-   \item W3C html specification about boolean attributes
-   \url{https://www.w3.org/TR/html5/infrastructure.html#sec-boolean-attributes}
- }
+\item W3C html specification about boolean attributes
+\url{https://www.w3.org/TR/html5/infrastructure.html#sec-boolean-attributes}
+}
 }
diff --git a/man/copyDependencyToDir.Rd b/man/copyDependencyToDir.Rd
index 9ac765c4..b3c98824 100644
--- a/man/copyDependencyToDir.Rd
+++ b/man/copyDependencyToDir.Rd
@@ -18,13 +18,12 @@ directory on disk (but rather a URL location), an error is raised. If
 }
 \value{
 The dependency with its \code{src} value updated to the new
-  location's absolute path.
+location's absolute path.
 }
 \description{
 Copies an HTML dependency to a subdirectory of the given directory. The
 subdirectory name will be \emph{name}-\emph{version} (for example,
-"outputDir/jquery-1.11.0"). You may set \code{options(htmltools.dir.version =
-FALSE)} to suppress the version number in the subdirectory name.
+"outputDir/jquery-1.11.0"). You may set \code{options(htmltools.dir.version = FALSE)} to suppress the version number in the subdirectory name.
 }
 \details{
 In order for disk-based dependencies to work with static HTML files, it's
@@ -33,6 +32,6 @@ HTML file, or to a subdirectory of that directory. This function makes it
 easier to perform that copy.
 }
 \seealso{
-\code{\link{makeDependencyRelative}} can be used with the returned
-  value to make the path relative to a specific directory.
+\code{\link[=makeDependencyRelative]{makeDependencyRelative()}} can be used with the returned
+value to make the path relative to a specific directory.
 }
diff --git a/man/css.Rd b/man/css.Rd
index 0ceac7e6..ff8507dc 100644
--- a/man/css.Rd
+++ b/man/css.Rd
@@ -12,7 +12,7 @@ the argument is the property value. See Details for conversion rules.}
 
 \item{collapse_}{(Note that the parameter name has a trailing underscore
 character.) Character to use to collapse properties into a single string;
-likely \code{""} (the default) for style attributes, and either \code{"\n"}
+likely \code{""} (the default) for style attributes, and either \code{"\\n"}
 or \code{NULL} for style blocks.}
 }
 \description{
diff --git a/man/figures/lifecycle-deprecated.svg b/man/figures/lifecycle-deprecated.svg
new file mode 100644
index 00000000..4baaee01
--- /dev/null
+++ b/man/figures/lifecycle-deprecated.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="124" height="20"><linearGradient id="b" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="a"><rect width="124" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#a)"><path fill="#555" d="M0 0h53v20H0z"/><path fill="#fe7d37" d="M53 0h71v20H53z"/><path fill="url(#b)" d="M0 0h124v20H0z"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"><text x="275" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">lifecycle</text><text x="275" y="140" transform="scale(.1)" textLength="430">lifecycle</text><text x="875" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="610">deprecated</text><text x="875" y="140" transform="scale(.1)" textLength="610">deprecated</text></g> </svg>
\ No newline at end of file
diff --git a/man/figures/lifecycle-experimental.svg b/man/figures/lifecycle-experimental.svg
new file mode 100644
index 00000000..d1d060e9
--- /dev/null
+++ b/man/figures/lifecycle-experimental.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="136" height="20"><linearGradient id="b" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="a"><rect width="136" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#a)"><path fill="#555" d="M0 0h53v20H0z"/><path fill="#fe7d37" d="M53 0h83v20H53z"/><path fill="url(#b)" d="M0 0h136v20H0z"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"><text x="275" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">lifecycle</text><text x="275" y="140" transform="scale(.1)" textLength="430">lifecycle</text><text x="935" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="730">experimental</text><text x="935" y="140" transform="scale(.1)" textLength="730">experimental</text></g> </svg>
\ No newline at end of file
diff --git a/man/figures/lifecycle-questioning.svg b/man/figures/lifecycle-questioning.svg
new file mode 100644
index 00000000..08ee0c90
--- /dev/null
+++ b/man/figures/lifecycle-questioning.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="126" height="20"><linearGradient id="b" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="a"><rect width="126" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#a)"><path fill="#555" d="M0 0h53v20H0z"/><path fill="#007ec6" d="M53 0h73v20H53z"/><path fill="url(#b)" d="M0 0h126v20H0z"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"><text x="275" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">lifecycle</text><text x="275" y="140" transform="scale(.1)" textLength="430">lifecycle</text><text x="885" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="630">questioning</text><text x="885" y="140" transform="scale(.1)" textLength="630">questioning</text></g> </svg>
\ No newline at end of file
diff --git a/man/figures/lifecycle-superseded.svg b/man/figures/lifecycle-superseded.svg
new file mode 100644
index 00000000..75f24f55
--- /dev/null
+++ b/man/figures/lifecycle-superseded.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="128" height="20"><linearGradient id="b" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="a"><rect width="128" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#a)"><path fill="#555" d="M0 0h55v20H0z"/><path fill="#007ec6" d="M55 0h73v20H55z"/><path fill="url(#b)" d="M0 0h128v20H0z"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"> <text x="285" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="450">lifecycle</text><text x="285" y="140" transform="scale(.1)" textLength="450">lifecycle</text><text x="905" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="630">superseded</text><text x="905" y="140" transform="scale(.1)" textLength="630">superseded</text></g> </svg>
\ No newline at end of file
diff --git a/man/findDependencies.Rd b/man/findDependencies.Rd
index 14027231..526ee087 100644
--- a/man/findDependencies.Rd
+++ b/man/findDependencies.Rd
@@ -12,7 +12,7 @@ findDependencies(tags, tagify = TRUE)
 \item{tagify}{Whether to tagify the input before searching for dependencies.}
 }
 \value{
-A list of \code{\link{htmlDependency}} objects.
+A list of \code{\link[=htmlDependency]{htmlDependency()}} objects.
 }
 \description{
 Walks a hierarchy of tags looking for attached dependencies.
diff --git a/man/htmlDependencies.Rd b/man/htmlDependencies.Rd
index 326f5ea8..50e4ebfd 100644
--- a/man/htmlDependencies.Rd
+++ b/man/htmlDependencies.Rd
@@ -31,7 +31,7 @@ x\})}, except that if there are any existing dependencies,
 
 As of htmltools 0.3.4, HTML dependencies can be attached without using
 \code{attachDependencies}. Instead, they can be added inline, like a child
-object of a tag or \code{\link{tagList}}.
+object of a tag or \code{\link[=tagList]{tagList()}}.
 }
 \examples{
 # Create a JavaScript dependency
diff --git a/man/htmlDependency.Rd b/man/htmlDependency.Rd
index 47da9e38..cc64fcfc 100644
--- a/man/htmlDependency.Rd
+++ b/man/htmlDependency.Rd
@@ -42,7 +42,7 @@ Details.}
 
 \item{package}{An R package name to indicate where to find the \code{src}
 directory when \code{src} is a relative path (see
-\code{\link{resolveDependencies}}).}
+\code{\link[=resolveDependencies]{resolveDependencies()}}).}
 
 \item{all_files}{Whether all files under the \code{src} directory are
 dependency files. If \code{FALSE}, only the files specified in
@@ -51,7 +51,7 @@ dependency files.}
 }
 \value{
 An object that can be included in a list of dependencies passed to
-  \code{\link{attachDependencies}}.
+\code{\link[=attachDependencies]{attachDependencies()}}.
 }
 \description{
 Define an HTML dependency (i.e. CSS and/or JavaScript bundled in a
@@ -61,59 +61,58 @@ script, link, and style tags.
 }
 \details{
 Each dependency can be located on the filesystem, at a relative or
-  absolute URL, or both. The location types are indicated using the names of
-  the \code{src} character vector: \code{file} for filesystem directory,
-  \code{href} for URL. For example, a dependency that was both on disk and at
-  a URL might use \code{src = c(file=filepath, href=url)}.
+absolute URL, or both. The location types are indicated using the names of
+the \code{src} character vector: \code{file} for filesystem directory,
+\code{href} for URL. For example, a dependency that was both on disk and at
+a URL might use \code{src = c(file=filepath, href=url)}.
 
-  \code{script} can be given as one of the following:
-  \itemize{
-  \item a character vector specifying various scripts to include relative to the
-    value of \code{src}.
-    Each is expanded into its own \code{<script>} tag
-  \item A named list with any of the following fields:
-  \itemize{
-    \item \code{src},
-    \item \code{integrity}, &
-    \item \code{crossorigin},
-    \item any other valid \code{<script>} attributes.
-    }
-    allowing the use of SRI to ensure the integrity of packages downloaded from
-    remote servers.
-    Eg: \code{script = list(src = "min.js", integrity = "hash")}
-  \item An unamed list, containing a combination of named list with the fields
-    mentioned previously, and strings.
-    Eg:
-    \itemize{
-    \item \code{script = list(list(src = "min.js"), "util.js", list(src = "log.js"))}
-    \item \code{script = "pkg.js"} is equivalent to
-    \item \code{script = list(src = "pkg.js")}.
-    }
-  }
+\code{script} can be given as one of the following:
+\itemize{
+\item a character vector specifying various scripts to include relative to the
+value of \code{src}.
+Each is expanded into its own \verb{<script>} tag
+\item A named list with any of the following fields:
+\itemize{
+\item \code{src},
+\item \code{integrity}, &
+\item \code{crossorigin},
+\item any other valid \verb{<script>} attributes.
+}
+allowing the use of SRI to ensure the integrity of packages downloaded from
+remote servers.
+Eg: \code{script = list(src = "min.js", integrity = "hash")}
+\item An unamed list, containing a combination of named list with the fields
+mentioned previously, and strings.
+Eg:
+\itemize{
+\item \code{script = list(list(src = "min.js"), "util.js", list(src = "log.js"))}
+\item \code{script = "pkg.js"} is equivalent to
+\item \code{script = list(src = "pkg.js")}.
+}
+}
 
-  \code{attachment} can be used to make the indicated files available to the
-  JavaScript on the page via URL. For each element of \code{attachment}, an
-  element \code{<link id="DEPNAME-ATTACHINDEX-attachment" rel="attachment"
-  href="...">} is inserted, where \code{DEPNAME} is \code{name}. The value of
-  \code{ATTACHINDEX} depends on whether \code{attachment} is named or not; if
-  so, then it's the name of the element, and if not, it's the 1-based index
-  of the element. JavaScript can retrieve the URL using something like
-  \code{document.getElementById(depname + "-" + index + "-attachment").href}.
-  Note that depending on the rendering context, the runtime value of the href
-  may be an absolute, relative, or data URI.
+\code{attachment} can be used to make the indicated files available to the
+JavaScript on the page via URL. For each element of \code{attachment}, an
+element \verb{<link id="DEPNAME-ATTACHINDEX-attachment" rel="attachment" href="...">} is inserted, where \code{DEPNAME} is \code{name}. The value of
+\code{ATTACHINDEX} depends on whether \code{attachment} is named or not; if
+so, then it's the name of the element, and if not, it's the 1-based index
+of the element. JavaScript can retrieve the URL using something like
+\verb{document.getElementById(depname + "-" + index + "-attachment").href}.
+Note that depending on the rendering context, the runtime value of the href
+may be an absolute, relative, or data URI.
 
-  \code{htmlDependency} should not be called from the top-level of a package
-  namespace with absolute paths (or with paths generated by
-  \code{system.file()}) and have the result stored in a variable. This is
-  because, when a binary package is built, R will run \code{htmlDependency}
-  and store the path from the building machine's in the package. This path is
-  likely to differ from the correct path on a machine that downloads and
-  installs the binary package. If there are any absolute paths, instead of
-  calling \code{htmlDependency} at build-time, it should be called at
-  run-time. This can be done by wrapping the \code{htmlDependency} call in a
-  function.
+\code{htmlDependency} should not be called from the top-level of a package
+namespace with absolute paths (or with paths generated by
+\code{system.file()}) and have the result stored in a variable. This is
+because, when a binary package is built, R will run \code{htmlDependency}
+and store the path from the building machine's in the package. This path is
+likely to differ from the correct path on a machine that downloads and
+installs the binary package. If there are any absolute paths, instead of
+calling \code{htmlDependency} at build-time, it should be called at
+run-time. This can be done by wrapping the \code{htmlDependency} call in a
+function.
 }
 \seealso{
-Use \code{\link{attachDependencies}} to associate a list of
-  dependencies with the HTML it belongs with.
+Use \code{\link[=attachDependencies]{attachDependencies()}} to associate a list of
+dependencies with the HTML it belongs with.
 }
diff --git a/man/htmlPreserve.Rd b/man/htmlPreserve.Rd
index 1ec2885a..0d840b53 100644
--- a/man/htmlPreserve.Rd
+++ b/man/htmlPreserve.Rd
@@ -22,16 +22,16 @@ restorePreserveChunks(strval, chunks)
 }
 \value{
 \code{htmlPreserve} returns a single-element character vector with
-  "magic" HTML comments surrounding the original text (unless the original
-  text was empty, in which case an empty string is returned).
+"magic" HTML comments surrounding the original text (unless the original
+text was empty, in which case an empty string is returned).
 
 \code{extractPreserveChunks} returns a list with two named elements:
-  \code{value} is the string with the regions replaced, and \code{chunks} is
-  a named character vector where the names are the IDs and the values are the
-  regions that were extracted.
+\code{value} is the string with the regions replaced, and \code{chunks} is
+a named character vector where the names are the IDs and the values are the
+regions that were extracted.
 
 \code{restorePreserveChunks} returns a character vector with the
-  chunk IDs replaced with their original values.
+chunk IDs replaced with their original values.
 }
 \description{
 Use "magic" HTML comments to protect regions of HTML from being modified by
diff --git a/man/htmlTemplate.Rd b/man/htmlTemplate.Rd
index 55cbef07..cf724507 100644
--- a/man/htmlTemplate.Rd
+++ b/man/htmlTemplate.Rd
@@ -24,8 +24,8 @@ for the string \code{"<HTML>"} within the template.}
 Process an HTML template and return a tagList object. If the template is a
 complete HTML document, then the returned object will also have class
 \code{html_document}, and can be passed to the function
-\code{\link{renderDocument}} to get the final HTML text.
+\code{\link[=renderDocument]{renderDocument()}} to get the final HTML text.
 }
 \seealso{
-\code{\link{renderDocument}}
+\code{\link[=renderDocument]{renderDocument()}}
 }
diff --git a/man/html_print.Rd b/man/html_print.Rd
index 9ae584b0..e040e3a4 100644
--- a/man/html_print.Rd
+++ b/man/html_print.Rd
@@ -23,5 +23,5 @@ Invisibly returns the URL or path of the generated HTML page.
 }
 \description{
 Convenience method that provides an implementation of the
-\code{\link[base:print]{print}} method for HTML content.
+\code{\link[base:print]{base::print()}} method for HTML content.
 }
diff --git a/man/include.Rd b/man/include.Rd
index 86dcf9a5..c12f4207 100644
--- a/man/include.Rd
+++ b/man/include.Rd
@@ -36,11 +36,11 @@ large literal R string.
 }
 \note{
 \code{includeText} escapes its contents, but does no other processing.
-  This means that hard breaks and multiple spaces will be rendered as they
-  usually are in HTML: as a single space character. If you are looking for
-  preformatted text, wrap the call with \code{\link{pre}}, or consider using
-  \code{includeMarkdown} instead.
+This means that hard breaks and multiple spaces will be rendered as they
+usually are in HTML: as a single space character. If you are looking for
+preformatted text, wrap the call with \code{\link[=pre]{pre()}}, or consider using
+\code{includeMarkdown} instead.
 
 The \code{includeMarkdown} function requires the \code{markdown}
-  package.
+package.
 }
diff --git a/man/makeDependencyRelative.Rd b/man/makeDependencyRelative.Rd
index f568bbd3..7b030e2f 100644
--- a/man/makeDependencyRelative.Rd
+++ b/man/makeDependencyRelative.Rd
@@ -28,5 +28,5 @@ Change a dependency's absolute path to be relative to one of its parent
 directories.
 }
 \seealso{
-\code{\link{copyDependencyToDir}}
+\code{\link[=copyDependencyToDir]{copyDependencyToDir()}}
 }
diff --git a/man/renderDependencies.Rd b/man/renderDependencies.Rd
index 6bbb7f27..4bc4bad1 100644
--- a/man/renderDependencies.Rd
+++ b/man/renderDependencies.Rd
@@ -24,8 +24,8 @@ default should generally be used.}
 script and stylesheet files. The default should generally be used.}
 }
 \value{
-An \code{\link{HTML}} object suitable for inclusion in the head of an
-  HTML document.
+An \code{\link[=HTML]{HTML()}} object suitable for inclusion in the head of an
+HTML document.
 }
 \description{
 Create the appropriate HTML markup for including dependencies in an HTML
diff --git a/man/renderDocument.Rd b/man/renderDocument.Rd
index 62b72640..e6a4b62a 100644
--- a/man/renderDocument.Rd
+++ b/man/renderDocument.Rd
@@ -8,26 +8,26 @@ renderDocument(x, deps = NULL, processDep = identity)
 }
 \arguments{
 \item{x}{An object of class \code{html_document}, typically generated by the
-\code{\link{htmlTemplate}} function.}
+\code{\link[=htmlTemplate]{htmlTemplate()}} function.}
 
 \item{deps}{Any extra web dependencies to add to the html document. This can
-be an object created by \code{\link{htmlDependency}}, or a list of such
+be an object created by \code{\link[=htmlDependency]{htmlDependency()}}, or a list of such
 objects. These dependencies will be added first, before other dependencies.}
 
 \item{processDep}{A function that takes a "raw" html_dependency object and
 does further processing on it. For example, when \code{renderDocument} is
-called from Shiny, the function \code{\link[shiny]{createWebDependency}} is
+called from Shiny, the function \code{\link[shiny:createWebDependency]{shiny::createWebDependency()}} is
 used; it modifies the href and tells Shiny to serve a particular path on
 the filesystem.}
 }
 \value{
-An \code{\link{HTML}} string, with UTF-8 encoding.
+An \code{\link[=HTML]{HTML()}} string, with UTF-8 encoding.
 }
 \description{
 This function renders \code{html_document} objects, and returns a string with
-the final HTML content. It calls the \code{\link{renderTags}} function to
+the final HTML content. It calls the \code{\link[=renderTags]{renderTags()}} function to
 convert any shiny.tag objects to HTML. It also finds any any web dependencies
-(created by \code{\link{htmlDependency}}) that are attached to the tags, and
+(created by \code{\link[=htmlDependency]{htmlDependency()}}) that are attached to the tags, and
 inserts those. To do the insertion, this function finds the string
 \code{"<!-- HEAD_CONTENT -->"} in the document, and replaces it with the web
 dependencies.
diff --git a/man/renderTags.Rd b/man/renderTags.Rd
index f5b63dfe..9425b758 100644
--- a/man/renderTags.Rd
+++ b/man/renderTags.Rd
@@ -22,30 +22,30 @@ be used.}
 \value{
 \code{renderTags} returns a list with the following variables:
 \describe{
-  \item{\code{head}}{An \code{\link{HTML}} string that should be included in
-    \code{<head>}.
-  }
-  \item{\code{singletons}}{Character vector of singleton signatures that are
-    known after rendering.
-  }
-  \item{\code{dependencies}}{A list of \link[=resolveDependencies]{resolved}
-    \code{\link{htmlDependency}} objects.
-  }
-  \item{\code{html}}{An \code{\link{HTML}} string that represents the main
-    HTML that was rendered.
-  }
+\item{\code{head}}{An \code{\link[=HTML]{HTML()}} string that should be included in
+\verb{<head>}.
+}
+\item{\code{singletons}}{Character vector of singleton signatures that are
+known after rendering.
+}
+\item{\code{dependencies}}{A list of \link[=resolveDependencies]{resolved}
+\code{\link[=htmlDependency]{htmlDependency()}} objects.
+}
+\item{\code{html}}{An \code{\link[=HTML]{HTML()}} string that represents the main
+HTML that was rendered.
+}
 }
 
-\code{doRenderTags} returns a simple \code{\link{HTML}} string.
+\code{doRenderTags} returns a simple \code{\link[=HTML]{HTML()}} string.
 }
 \description{
 Renders tags (and objects that can be converted into tags using
-\code{\link{as.tags}}) into HTML. (Generally intended to be called from web
+\code{\link[=as.tags]{as.tags()}}) into HTML. (Generally intended to be called from web
 framework libraries, not directly by most users--see
-\code{\link{print.html}(browse=TRUE)} for higher level rendering.)
+\verb{[print.html](browse=TRUE)} for higher level rendering.)
 }
 \details{
 \code{doRenderTags} is intended for very low-level use; it ignores
-  singleton, head, and dependency handling, and simply renders the given tag
-  objects as HTML.
+singleton, head, and dependency handling, and simply renders the given tag
+objects as HTML.
 }
diff --git a/man/resolveDependencies.Rd b/man/resolveDependencies.Rd
index 1c3bb4d7..2eea557a 100644
--- a/man/resolveDependencies.Rd
+++ b/man/resolveDependencies.Rd
@@ -7,15 +7,15 @@
 resolveDependencies(dependencies, resolvePackageDir = TRUE)
 }
 \arguments{
-\item{dependencies}{A list of \code{\link{htmlDependency}} objects.}
+\item{dependencies}{A list of \code{\link[=htmlDependency]{htmlDependency()}} objects.}
 
 \item{resolvePackageDir}{Whether to resolve the relative path to an absolute
-path via \code{\link{system.file}} when the \code{package} attribute is
+path via \code{\link[=system.file]{system.file()}} when the \code{package} attribute is
 present in a dependency object.}
 }
 \value{
-dependencies A list of \code{\link{htmlDependency}} objects with
-  redundancies removed.
+dependencies A list of \code{\link[=htmlDependency]{htmlDependency()}} objects with
+redundancies removed.
 }
 \description{
 Given a list of dependencies, removes any redundant dependencies (based on
diff --git a/man/save_html.Rd b/man/save_html.Rd
index 9ee734ff..526b0767 100644
--- a/man/save_html.Rd
+++ b/man/save_html.Rd
@@ -16,7 +16,7 @@ sub-directory, the sub-directory must already exist.}
 
 \item{libdir}{Directory to copy dependencies to}
 
-\item{lang}{Value of the `<html>` `lang` attribute}
+\item{lang}{Value of the \verb{<html>} \code{lang} attribute}
 }
 \description{
 Save the specified HTML object to a file, copying all of it's
diff --git a/man/singleton.Rd b/man/singleton.Rd
index bd1ac458..ed98bcbf 100644
--- a/man/singleton.Rd
+++ b/man/singleton.Rd
@@ -10,7 +10,7 @@ singleton(x, value = TRUE)
 is.singleton(x)
 }
 \arguments{
-\item{x}{A \code{\link{tag}}, text, \code{\link{HTML}}, or list.}
+\item{x}{A \code{\link[=tag]{tag()}}, text, \code{\link[=HTML]{HTML()}}, or list.}
 
 \item{value}{Whether the object should be a singleton.}
 }
diff --git a/man/singleton_tools.Rd b/man/singleton_tools.Rd
index 2bfeb61c..27a6d255 100644
--- a/man/singleton_tools.Rd
+++ b/man/singleton_tools.Rd
@@ -22,14 +22,14 @@ encountered should have the singleton attribute removed.}
 }
 \value{
 \code{surroundSingletons} preprocesses a tag object by changing any
-  singleton X into <!--SHINY.SINGLETON[sig]-->X'<!--/SHINY.SINGLETON[sig]-->
-  where sig is the sha1 of X, and X' is X minus the singleton attribute.
+singleton X into \verb{<!--SHINY.SINGLETON[sig]-->X'<!--/SHINY.SINGLETON[sig]-->}
+where sig is the sha1 of X, and X' is X minus the singleton attribute.
 
 \code{takeSingletons} returns a list with the elements \code{ui} (the
-  processed tag objects with any duplicate singleton objects removed) and
-  \code{singletons} (the list of known singleton signatures).
+processed tag objects with any duplicate singleton objects removed) and
+\code{singletons} (the list of known singleton signatures).
 }
 \description{
-Functions for manipulating \code{\link{singleton}} objects in tag
+Functions for manipulating \code{\link[=singleton]{singleton()}} objects in tag
 hierarchies. Intended for framework authors.
 }
diff --git a/man/subtractDependencies.Rd b/man/subtractDependencies.Rd
index 4a5645cf..1ebd2e8a 100644
--- a/man/subtractDependencies.Rd
+++ b/man/subtractDependencies.Rd
@@ -7,10 +7,10 @@
 subtractDependencies(dependencies, remove, warnOnConflict = TRUE)
 }
 \arguments{
-\item{dependencies}{A list of \code{\link{htmlDependency}} objects from which
+\item{dependencies}{A list of \code{\link[=htmlDependency]{htmlDependency()}} objects from which
 dependencies should be removed.}
 
-\item{remove}{A list of \code{\link{htmlDependency}} objects indicating which
+\item{remove}{A list of \code{\link[=htmlDependency]{htmlDependency()}} objects indicating which
 dependencies should be removed, or a character vector indicating dependency
 names.}
 
@@ -20,8 +20,8 @@ has a lower version number. Has no effect if \code{remove} is provided as a
 character vector.}
 }
 \value{
-A list of \code{\link{htmlDependency}} objects that don't intersect
-  with \code{remove}.
+A list of \code{\link[=htmlDependency]{htmlDependency()}} objects that don't intersect
+with \code{remove}.
 }
 \description{
 Remove a set of dependencies from another list of dependencies. The set of
diff --git a/man/suppressDependencies.Rd b/man/suppressDependencies.Rd
index cb711135..76e86405 100644
--- a/man/suppressDependencies.Rd
+++ b/man/suppressDependencies.Rd
@@ -16,8 +16,8 @@ dependency (like a JavaScript or CSS file) is declared in raw HTML, in an
 HTML template.
 }
 \seealso{
-\code{\link{htmlTemplate}} for more information about using HTML
-  templates.
+\code{\link[=htmlTemplate]{htmlTemplate()}} for more information about using HTML
+templates.
 
-\code{\link[htmltools]{htmlDependency}}
+\code{\link[=htmlDependency]{htmlDependency()}}
 }
diff --git a/man/tag.Rd b/man/tag.Rd
index 541f9e31..d3425c26 100644
--- a/man/tag.Rd
+++ b/man/tag.Rd
@@ -44,7 +44,7 @@ tag(`_tag_name`, varArgs, .noWS = NULL)
 \item{varArgs}{List of attributes and children of the element. Named list
 items become attributes, and unnamed list items become children. Valid
 children are tags, single-character character vectors (which become text
-nodes), and raw HTML (see \code{\link{HTML}}). You can also pass lists that
+nodes), and raw HTML (see \code{\link[=HTML]{HTML()}}). You can also pass lists that
 contain tags, text nodes, and HTML.}
 
 \item{.noWS}{Character vector used to omit some of the whitespace that would
@@ -54,11 +54,11 @@ Any number of these options can be specified.}
 }
 \value{
 An HTML tag object that can be rendered as HTML using
-  \code{\link{as.character}()}.
+\code{\link[=as.character]{as.character()}}.
 }
 \description{
 \code{tag()} creates an HTML tag definition. Note that all of the valid HTML5
-tags are already defined in the \code{\link{tags}} environment so these
+tags are already defined in the \code{\link[=tags]{tags()}} environment so these
 functions should only be used to generate additional tags.
 \code{tagAppendChild()} and \code{tagList()} are for supporting package
 authors who wish to create their own sets of tags; see the contents of
diff --git a/man/tagFunction.Rd b/man/tagFunction.Rd
index 0ade7443..b1da95b2 100644
--- a/man/tagFunction.Rd
+++ b/man/tagFunction.Rd
@@ -11,7 +11,7 @@ tagFunction(func)
 dependencies.}
 }
 \description{
-Create 'lazily' rendered HTML [tags] (and/or [htmlDependencies()]).
+Create 'lazily' rendered HTML \link{tags} (and/or \code{\link[=htmlDependencies]{htmlDependencies()}}).
 }
 \examples{
 
diff --git a/man/tagQuery.Rd b/man/tagQuery.Rd
index 1bd324c7..8053fdcf 100644
--- a/man/tagQuery.Rd
+++ b/man/tagQuery.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/tag_query.R
 \name{tagQuery}
 \alias{tagQuery}
-\title{Tag Query - Perform jQuery-like alterations on tag objects}
+\title{Perform jQuery-like alterations on tags}
 \usage{
 tagQuery(tags)
 }
diff --git a/man/urlEncodePath.Rd b/man/urlEncodePath.Rd
index b8932769..0c177776 100644
--- a/man/urlEncodePath.Rd
+++ b/man/urlEncodePath.Rd
@@ -11,6 +11,6 @@ urlEncodePath(x)
 }
 \description{
 Encode characters in a URL path. This is the same as
-\code{\link[utils]{URLencode}} with \code{reserved = TRUE} except that
+\code{\link[utils:URLencode]{utils::URLencode()}} with \code{reserved = TRUE} except that
 \code{/} is preserved.
 }
diff --git a/man/validateCssUnit.Rd b/man/validateCssUnit.Rd
index cae8daff..31e2611f 100644
--- a/man/validateCssUnit.Rd
+++ b/man/validateCssUnit.Rd
@@ -12,7 +12,7 @@ unit is not specified.}
 }
 \value{
 A properly formatted CSS unit of length, if possible. Otherwise, will
-  throw an error.
+throw an error.
 }
 \description{
 Checks that the argument is valid for use as a CSS unit of length.
@@ -26,12 +26,11 @@ number plus a suffix of \code{"px"}.
 Single element character vectors must be \code{"auto"}, \code{"fit-content"}
 or \code{"inherit"}, a number, or a length calculated by the \code{"calc"}
 CSS function. If the number has a suffix, it must be valid: \code{px},
-\code{\%}, \code{ch}, \code{em}, \code{rem}, \code{pt}, \code{in}, \code{cm},
+\verb{\\\%}, \code{ch}, \code{em}, \code{rem}, \code{pt}, \verb{in}, \code{cm},
 \code{mm}, \code{ex}, \code{pc}, \code{vh}, \code{vw}, \code{vmin}, or
 \code{vmax}.
 If the number has no suffix, the suffix \code{"px"} is appended.
 
-
 Any other value will cause an error to be thrown.
 }
 \examples{
diff --git a/pkgdown/_pkgdown.yml b/pkgdown/_pkgdown.yml
new file mode 100644
index 00000000..ec6b35d4
--- /dev/null
+++ b/pkgdown/_pkgdown.yml
@@ -0,0 +1,93 @@
+url: https://rstudio.github.io/htmltools/
+
+# development:
+#   mode: auto
+
+
+# template:
+#  # assets: pkgdown/assets
+#   params:
+#     docsearch:
+#       api_key: 'e8f0e2420e2e9aac7973efb2cc877b06'
+#       index_name: 'rplumber'
+
+# articles:
+# - title: Creating APIs in R with Plumber
+#   navbar: ~
+#   # desc: description here
+#   contents:
+#   - 'introduction'
+#   - 'quickstart'
+#   - 'routing-and-input'
+#   - 'rendering-output'
+#   - 'execution-model'
+#   - 'security'
+#   - 'hosting'
+#   - 'programmatic-usage'
+#   - 'annotations'
+#   - 'tips-and-tricks'
+#   - 'migration'
+
+
+reference:
+
+- title: Tags
+  contents:
+  - '`builder`'
+  - '`HTML`'
+  - '`tag`'
+  - '`plotTag`'
+  - '`include`'
+  - '`browsable`'
+  - '`as.tags`'
+  - '`withTags`'
+
+- title: Rendering tags
+  contents:
+  - '`print.html`'
+  - '`renderDependencies`'
+  - '`renderDocument`'
+  - '`renderTags`'
+  - '`save_html`'
+  - '`html_print`'
+
+- title: Singleton tag
+  contents:
+  - '`singleton`'
+  - '`singleton_tools`'
+
+- title: HTML templates
+  contents:
+  - '`htmlTemplate`'
+  - '`htmlPreserve`'
+
+- title: HTML dependencies
+  contents:
+  - '`htmlDependency`'
+  - '`htmlDependencies`'
+  - '`findDependencies`'
+  - '`subtractDependencies`'
+  - '`suppressDependencies`'
+  - '`copyDependencyToDir`'
+  - '`makeDependencyRelative`'
+  - '`resolveDependencies`'
+
+- title: Plot handling
+  contents:
+  - '`plotTag`'
+  - '`capturePlot`'
+  - '`defaultPngDevice`'
+
+- title: Utilities
+  contents:
+  - '`css`'
+  - '`parseCssColors`'
+  - '`htmlEscape`'
+  - '`urlEncodePath`'
+  - '`validateCssUnit`'
+  - '`knitr_methods`'
+
+- title: Advanced tag objects
+  contents:
+  - '`tagQuery`'
+  - '`tagFunction`'