34

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
---
Cainã Max Couto-Silva
  • 4,839
  • 1
  • 11
  • 35
Thomas Speidel
  • 1,369
  • 1
  • 14
  • 26
  • 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

3 Answers3

29

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 
---
Philipp R
  • 598
  • 6
  • 22
27

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.

SabDeM
  • 7,050
  • 2
  • 25
  • 38
25

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.

user2225804
  • 761
  • 8
  • 22
  • 5
    This is the only solution that worked for the `bookdown::pdf_document2` document type for me. – pbaylis Nov 21 '18 at 22:38
  • 3
    Works with `word_document` and `bookdown::word_document2` too – Cath Nov 15 '19 at 14:44
  • Does not work for me. I am using output: beamer_presentation: – wolfsatthedoor Sep 17 '22 at 15:44
  • This solution did not work for `word_document` and `bookdown::word_document2` in the year 2023. The solution that did work I got from this link: [link](https://tex.stackexchange.com/questions/502581/multi-line-titles-with-pandoc). – ESELIA Jan 20 '23 at 19:42