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

101

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,754
2
27
26

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

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

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

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

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

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

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
---

score 2 · 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!

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

3 Answers3

Linked

Related