89

In RMarkdown is there a way to specify the font color?

There doesn't seem to be an option while browsing through the chunk options

xiaodai
  • 14,889
  • 18
  • 76
  • 140

8 Answers8

108

The answer given at the link provided by @Ben Bolker:

Roses are <span style="color:red">red</span>, 
violets are <span style="color:blue">blue</span>.

does work if you select HTML (ioslides) as the output format.

However, it does not work if you select pdf (beamer) as output format. If you want to create a pdf, use LaTeX syntax:

    Roses are \textcolor{red}{red}, violets are \textcolor{blue}{blue}.
Nadja Simons
  • 1,196
  • 1
  • 7
  • 10
  • 3
    Could you clarify the pdf part -- I cannot make it work: `undefined control sequence \textcolor`. The command is `pandoc ./main.md -o ./main.pdf`. The text in the main is the simplest `\textcolor{red}{red}`. What translation command do you use? – Ayrat Aug 05 '16 at 11:43
  • Dear Ayrat, I am using markdown within RStudio, so I am not very familiar with the pandoc commands. It is probably not related to the color command, but a problem with your system setup. See for example, here: http://stackoverflow.com/questions/37156696/undefined-control-sequence-error-while-converting-from-markdown-to-pdf-with-pand – Nadja Simons Aug 08 '16 at 07:20
  • 3
    If you're using R Markdown and a similar error appears, add `header-includes: \usepackage{xcolor}` in the preamble section – aldo_tapia May 23 '19 at 20:54
  • https://dr-harper.github.io/rmarkdown-cookbook/changing-font-colour.html here can you also find the full example about how to add color using LaTeX. – user1682960 Aug 14 '19 at 10:10
49

I create a function like this:

## Color Format
colFmt <- function(x,color) {
  
  outputFormat <- knitr::opts_knit$get("rmarkdown.pandoc.to")
  
  if(outputFormat == 'latex') {
    ret <- paste("\\textcolor{",color,"}{",x,"}",sep="")
  } else if(outputFormat == 'html') {
    ret <- paste("<font color='",color,"'>",x,"</font>",sep="")
  } else {
    ret <- x
  }

  return(ret)
}

Then you can use it inline like this:`r colFmt("MY RED TEXT",'red')`, and colored text will be rendered regardless of whether working on latex or HTML document.

January
  • 16,320
  • 6
  • 52
  • 74
Nicholas Hamilton
  • 10,044
  • 6
  • 57
  • 88
  • Using an up-to-date Rstudio and `rmarkdown::render` for pdf output this gets converted to `$\backslash$` in the tex file for me. Thus literally printing the string rather than interpreting it as latex. Very annoying. Do you have any ideas? – Midnighter Dec 15 '16 at 23:15
  • By any chance, is this happening in a table using xtable? – Nicholas Hamilton Dec 17 '16 at 00:16
  • As you figured out, yes indeed, inside of `xtable` as per my answer. – Midnighter Dec 18 '16 at 21:43
  • Please, note that the HTML `` tag is now obsolete. Its support could be removed at any time by browsers. – RLesur Jun 08 '19 at 17:48
  • @Nicholas Hamilton: Thank you for providing your very useful fct! How would I need to adapt it to work with transparent colors? See my [SO question here](https://stackoverflow.com/questions/64694618/r-markdown-specifying-transparent-color-in-html-and-pdf-output) – mavericks Nov 05 '20 at 09:41
27

This seems to work very well in both output formats, pdf and html:

Roses are $\color{red}{\text{beautiful red}}$, 
violets are $\color{blue}{\text{lovely blue}}$.

Hope it helps.

amanas
  • 490
  • 5
  • 8
  • That worked for me for changing text color inline. Thanks for the suggestion. Just a note for others, that is LaTex syntax rather than R – SubstantiaN Jun 25 '18 at 20:52
  • This worked also for me! I want to point out that it is taking advance of LaTeX functionalities which maybe is not always possible. I imagine that it could cause font problems if you have a specific font for the text for example. – Garini Oct 23 '18 at 09:40
  • works well in Jupyter too, since it supports MathJax (subset of Tex and LaTex) https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Typesetting%20Equations.html – prusswan Nov 08 '18 at 14:59
20

An output-format agnostic solution would be to use the dedicated text_spec() function in the kableExtra package:

Roses are `r kableExtra::text_spec("red", color = "red")`,

violets are `r kableExtra::text_spec("blue", color = "blue")`
Droplet
  • 935
  • 9
  • 12
10

Others have provided answers for output other than Word. For Word, you can use the Pandoc custom-style syntax to accomplish this with the aid of a reference word document. First, inside your reference.docx template, create a new Word style with a short, distinct name. If you want your font color to apply to a full paragraph, you can use the default, “Linked Paragraph and Character” style type. If you only want to emphasize some words in a paragraph with color, you need to select the “Character” style type. Change the font color (and any other styling you need) and save the reference.docx file.

Then, inside your .Rmd file, you can use the tag as follows:

<div custom-style=“DivCol”>Whole paragraph of colored text</div>

Just a <span custom-style=“SpanCol”>few words</span> of colored text

A word regarding style names - for reasons I don’t understand, this process did not work with the style name “Span_Add” but “SpanAdd” was fine.

ErinMcJ
  • 593
  • 6
  • 20
  • I have read elsewhere that underscores can cause issues in chunk names etc, so I assume this is the reason. They recommend using a dash '-' rather than underscore '_' in these instances: https://github.com/rstudio/bookdown/issues/313, https://bookdown.org/yihui/rmarkdown/r-code.html – hugh-allan Aug 05 '21 at 05:54
  • Just confirmed that this solution also works with regular .md files. Pandoc converts it to .docx all the same without R's knittr. – Clokman Aug 09 '21 at 23:26
  • This does not seem to work for me. Do I need to do something in order to enable the use of the span tags? – Magnus Aug 10 '21 at 11:48
5

I basically used Nicholas Hamilton's answer but because I used xtable and print, I had some problems with certain latex sequences being escaped. Namely, \\textcolor being transformed to $\backslash$textcolor. I was able to get it right by avoiding sanitizing in the following way:

```{r results='asis'}
tbl = data.frame(a = letters[1:10], b = 1:10 / 10)
tbl$b = ifelse(tbl$b < 0.5, colFmt(tbl$b, "red"), colFmt(tbl$b, "green"))
print(xtable(tbl), sanitize.text.function = identity)
```

I then had to go and manually sanitize a few characters like % but at least \textcolor was correctly applied. Of course, this could be avoided by expanding your own sanitize function.

Midnighter
  • 3,771
  • 2
  • 29
  • 43
1

For PDF and HTML, to get colored text which you can modify with markdown highlighting : see the rmarkdown book. Pandoc filter is the best choice.

For Microsoft word, you have to create first a Template_MS.docx with custom styles. Warning: create different styles for coloring paragraphs (paragraph style) and for colorings few words (character style). It is an option when you made a new style.

Add in th YAML:

---      
output:   
 word_document:   
    reference_docx: Template_MS.docx   
---   

And next:

For <span custom-style="Character1">few words</span> of colored text.

For paragraph.

<div custom-style="Paragraph1">Paragraph of colored text. Blabla. Blabla.</div>   

Nota Bene:
+ Do not use the same style for Paragraph and a few words, it is bugging.
+ If it is not working, check that your style is for paragraph ou character in MS.
+ If it is not working, install an updated version of pandoc.

  • This didn't work for me. Instead I had to add the following to my YAML (note the large gaps are because I cannot add newlines within a comment), which was based on this [link](https://www.andreashandel.com/post/word-formatting-rmarkdown/): `output: bookdown::word_document2: reference_docx: Template_MS.docx` – LMc Jan 07 '21 at 18:52
1

Easily change the font color with sass

There's a new and better way of specifying colors or fonts in R Markdown:

  • Download the package sass
  • Create a chunk in your RMarkdown document with the following options {sass, echo = FALSE}
  • include the following SASS code in that chunk:
// This chunk contains SASS-code to specify font color

h1, h2, h3, h4, h5
  color: blue // Color for the headers

body
  color: red // Color for the text in the main part of your document

// The colors are only examples. You can change them to anything. You could also use hex codes.

You can also change much more than just the font color

Typically, I include something like this in my documents, to also change the font type, the sizes, the link colors etc.:

// These are variables, and are easy to change
$color: blue
$color2: red
$font: "Arial"
$font-size: 16px

h1, h2, h3, h4, h5
  color: $color
  font-family: $font
  font-weight: bold

body
  background-color: white
  color: black
  font-family: $font
  font-size: $font-size

a
  color: $color

a:link
  color: $color

a:hover
  background-color: $color2

You can change any HTML tag you can think of this way.

Read more about SASS here.

jpiversen
  • 3,062
  • 1
  • 8
  • 12