Cross-referencing within documents with R Markdown

Question

I have a very simple document in R Markdown. Here is the code:

---
title: "Untitled"
output: html_document
---

# R Markdown {#r-mkdw}


This is an R Markdown document. Markdown is a simple formatting syntax for authoring HTML, PDF, and MS Word documents. I want to cross-reference the Header of this text with \@ref(r-mkdw).

But the cross-reference as the manual specifies doesn't work.

score 1 · Answer 1 · answered May 30 '20 at 07:06

1

The "standard" rmarkdown package with html_output does not support cross referencing. You have to use, e.g. the package bookdown which provides the format html_document2.

---
title: "Untitled"
output: 
  bookdown::html_document2
---

answered May 30 '20 at 07:06

J_F

9,956
2
31
55

Thank you. I have a separate _output.yml file with "--- bookdown::html_document2: default bookdown::gitbook" and still, it doesn't work. – Nicolás Sacco Jun 01 '20 at 14:29
Can you Provide your Project? – J_F Jun 01 '20 at 14:33
What do you mean by Project? – Nicolás Sacco Jun 03 '20 at 20:08
ALSO, THIS DOESN'T WORK--- title: "Untitled" output: bookdown::html_document2 --- # R Markdown This is an R Markdown document. Markdown is a simple formatting syntax for authoring HTML, PDF, and MS Word documents. I want to cross-reference the Header of this text with \@ref(sec:r-markdown). – Nicolás Sacco Jun 03 '20 at 20:11
but it works if you add this to your header `# R Markdown {#r-mkdw}`. Then you can refer to that with `\@ref(r-mkdw)`. – J_F Jun 04 '20 at 05:25
No. it's so strange, no idea what's going on. – Nicolás Sacco Jun 04 '20 at 18:29

Cross-referencing within documents with R Markdown

1 Answers1