Issue with pdf rendering

[shubhamdutta26]

Description

I am inserting a pagebreak using shortcode {{< pagebreak >}} in a pdf document. The Header 2 "## Table" is rendered after the actual table in the document. I did try \newpage and \pagebreak but it didnot work. How can I fix this?

---
title: "Untitled"
format: pdf
editor: visual
execute: 
  echo: false
---

## Quarto

Quarto enables you to weave together content and executable code into a finished document. To learn more about Quarto see <https://quarto.org>.

## Running Code

When you click the **Render** button a document will be generated that includes both content and the output of embedded code. You can embed code like this:

{{< pagebreak >}}

## Table

```{r}
library(gt)
head(mtcars) |>
  gt()
```

[mcanouil]

That's a LaTeX issue with floating object, they float.

Don't let gt emits LaTeX table and set position to "H".

```{r}
#| tbl-pos: H
library(gt)
as_raw_html(gt(head(mtcars)))
```

[cderv]

I am puzzled by this solution.

First, it seems you solved by using raw HTML table, but I would have expected #| tbl-pos: H to work with LaTeX output from gt.

Also, producing HTML will be trigger the HTML table parsing and Pandoc will produce the .tex. If you use keep-tex: true, you will see longtable is used, and I don't think longtable requires table placement.

So not sure tbl-pos is part of the solution here; Just using HTML table change the way the table is written.

Don't let gt emits LaTeX table

gt emitting LaTeX is supposed to be supported. If this is not working, it is either an issue in Quarto when processing output or in how gt writes.

Like raw latex table are supposed to be supported but I know there is some issues to fix like

• Problem parsing raw LaTeX table environment with option (like H position) #9522

Regarding gt output, they did change recently from longtable (not floating) to tabular inside table (floating), so I think this is what you see @shubhamdutta26. tbl-pos is supposed to be used if I understanding correctly as deactivated their gt option for it. Discussion in

• LaTeX Table Position Argument not used in qmd rstudio/gt#1853

@shubhamdutta26 You can get back previous behavior with this option

```{r}
library(gt)
head(mtcars) |>
  gt() |> 
  tab_options(latex.use_longtable = TRUE)
```

This will be ok in Quarto as long as you don't use crossreference in quarto, as longtable is not ideal. (but works in most cases)

Other note: Dev version of gt does not have the issue, as they did not emit anymore the table environment. See

• gt() table placement in LaTeX / PDF output doesn't work as expected rstudio/gt#2003 (olivroy/gt@837f2d7)

So using dev version would solve this.

However, with current CRAN version tbl-pos should work, when using cross referenced table

```{r}
#| label: tbl-mtcars
#| tbl-pos: H
library(gt)
head(mtcars) |>
  gt()
```

In that case

\begin{table}[H]

will be added around tabular environment from gt

Just doing

```{r}
#| tbl-pos: H
library(gt)
head(mtcars) |>
  gt()
```

won't for some reason. I can't say for sure if Quarto is supposed to process the raw latex table or not.

There is definitely some work to be done on LaTeX table. And I think this is worth looking more deeply.

@rich-iannone we really need to work on that closely together. This would be the opportunity to try a few scenarios, and really do the right thing gt at the right time.