Section break starts the new section on the same page. This type of section break is often used to change the number of columns without starting a new page.
Section breaks occupy a line
Ending a section is materialized in the document by an empty
paragraph mark holding the section properties; this is how the
OOXML format represents a section break, there is no other way, and
Word does the same when a section break is inserted manually. As
any paragraph mark, it occupies one line whose height depends on
the default paragraph style. The same applies to
run_columnbreak() when it has to be placed after a table: a table
cannot host the break, so it must live in a paragraph that also
takes one line. If that residual line matters for your layout,
define a dedicated paragraph style with a very small font size
(e.g. 1pt) and no spacing in your Word template, and use it for the
paragraph hosting the break:
fpar(run_columnbreak(), fp_p = fp_par(word_style = "MyTinyStyle")).
See also
Other functions for Word sections:
body_end_block_section(),
body_end_section_columns(),
body_end_section_columns_landscape(),
body_end_section_landscape(),
body_end_section_portrait(),
body_set_default_section()
Examples
str1 <- "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
str1 <- rep(str1, 5)
str1 <- paste(str1, collapse = " ")
str2 <- "Aenean venenatis varius elit et fermentum vivamus vehicula."
str2 <- rep(str2, 5)
str2 <- paste(str2, collapse = " ")
doc_1 <- read_docx()
doc_1 <- body_add_par(doc_1, value = "Default section", style = "heading 1")
doc_1 <- body_add_par(doc_1, value = str1, style = "Normal")
doc_1 <- body_add_par(doc_1, value = str2, style = "Normal")
doc_1 <- body_end_section_continuous(doc_1)
print(doc_1, target = tempfile(fileext = ".docx"))