How can I force a line break in rmarkdown's title?

Question

I have a quite long title in a rmarkdown document and I would like to force a line break in a specific position.

Minimum example:

---
title: "Quite long title want the * line break at the asterisk"
output: html_document
---

I have tried: \n, \newline, \\ and a manual line break. None of them seem to work.

I believe it has to be quite straightforward but I haven't been able to find a solution.

Peter Diakumis · Accepted Answer · 2015-03-06T09:29:04.017

111

Try using a pipe | in each line:

---
title: |
  | Veryyyyyyy  
  | yyyyyyyyyyyyyy Looooo  
  | oooooooooooooooo
  | oooooooooooong 

author: "Foo Bar"
date: "6 March 2015"
output: html_document
---

enter image description here

edited Mar 06 '15 at 09:29

answered Mar 06 '15 at 08:55

Peter Diakumis

3,942
2
28
26

Worked like a charm. Thanks – Jon Nagra Mar 06 '15 at 12:49
31

Note that the 4 spaces before the pipe and the single space after pipe are essential! – HansHarhoff Apr 07 '16 at 08:34
3

2 spaces before the pipe (as in the code above) works too – Chris Holbrook Jan 25 '17 at 04:38
3

Two spaces before the pipe, one after, with no quotation marks, works now for me. – Larry Hunsicker Aug 27 '17 at 18:22
8

Any idea why this works in output styles pdf_document and html_document but not word_document? Any way to achieve the same thing with a word doc? – enRANDOMSTRING Sep 22 '18 at 04:56
1

First, thanks a lot! It worked for me but using the pipe just in the first line. For each line break, I added two spaces at the end but not any pipe character. – george May 28 '21 at 14:43
This no longer works. – jzadra Nov 09 '22 at 22:52
Just tried it again after 7.5 years and it still works on my Mac at least. – Peter Diakumis Nov 15 '22 at 23:19

score 22 · Answer 2 · answered Jun 14 '18 at 20:55

22

For a centered, multi-line title:

---
title: |
  <center> Veryyyyyyy </center>
  <center> yyyyyyyyyyyyyy Looooo </center>
  <center> oooooooooooooooo </center>
  <center> oooooooooooong </center>

author: "Foo Bar"
date: "6 March 2015"
output: html_document
---

answered Jun 14 '18 at 20:55

filups21

1,611
1
19
22

How does this work for beamer rmarkdown titles? I get an error when I try it – wolfsatthedoor Sep 17 '22 at 15:43

score 3 · Answer 3 · answered Sep 24 '19 at 18:52

I know that this is an old post, but I wanted to chime in with:

# A Title of some kind
<br><br><br><br><br>  

# Another title that has 5 blank lines above it

Note that you need 2 spaces on line 3 or the title will not display properly in Rmarkdown::html_document. This solution is a little hard to find, hope it helps!

score 0 · Answer 4 · answered Nov 13 '22 at 18:45

i cannot comment on the chosen answer. The preferred solution makes a warning appear as it creates a table inside the title. A correct approach for multiline titles should be the following:

---
title: |
    Quite long title want the
    line break at the asterisk

output: html_document
---

How can I force a line break in rmarkdown's title?

4 Answers4

Linked

Related