Split the title onto multiple lines?

Question

In an R markdown document (html and presentations), is it possible to manually split the title onto multiple lines? I tried playing with pipes which produces orrendous output.

---
title:  'A title I want to split on two lines'
author: 
date: 
output:
  ioslides_presentation
---

Possible duplicate of [In YAML, how do I break a string over multiple lines?](http://stackoverflow.com/questions/3790454/in-yaml-how-do-i-break-a-string-over-multiple-lines) — scoa, Jan 03 '17 at 13:37

Philipp R · Answer 1 · 2017-01-16T03:23:43.367

25

Examples for adding an abtract show the use of pipes | to break lines and include paragraphs. This works as well for the title and other yaml elements. For an abstract or title:

---
abstract: |
    What works for the abstract.

    Works for the title, too!
title: |
    | title 
    | subtitle
output: pdf_document 
---

edited Jan 16 '17 at 03:23

answered Jan 03 '17 at 13:24

Philipp R

538
6
22

7

This is a beautiful solution. Thank you _so much_ for writing this. – coatless Aug 24 '17 at 15:50
1

Fwiw, OP already mentioned trying pipes, which indeed do not work for ioslides_presentation as far as I can tell. – Frank Jun 28 '18 at 17:51
This is the most helpful solution. – Matthew Son Jan 31 '22 at 20:38
This is **THE** correct solution!! Also recommended for all other fields, e.g. author. You can compile in all formats, unlike the other suggestions... – tchevrier Apr 05 '22 at 17:22

SabDeM · Accepted Answer · 2015-05-29T19:40:50.700

For an HTML output just us the <br> tag while if your output is a PDF or PDF presentation standard LaTeX code to break line given by \\ should work.

Example

---
title:  'A title I want to <br> split on two lines'
author: 
date: 
output:
  ioslides_presentation
---

For PDF

Just to rule out possibilities, I've tried to put \\ or \newline, both do not split, so for PDF seems to be a little bit tricky. \linebreak stop knitr parsing. Maybe another user can solve this question for knitr PDFs.

score 20 · Answer 3 · answered Dec 06 '16 at 20:17

20

For PDF output, experimentation revealed that the following works:

---
title:  'A title I want to  \nsplit on two lines'
author: 
date: 
output: pdf_document
---

That is two spaces followed by \n.

answered Dec 06 '16 at 20:17

user2225804

691
7
21

5

This is the only solution that worked for the `bookdown::pdf_document2` document type for me. – pbaylis Nov 21 '18 at 22:38
2

Works with `word_document` and `bookdown::word_document2` too – Cath Nov 15 '19 at 14:44

Split the title onto multiple lines?

3 Answers3

Example

For PDF

Linked

Related