Bookdown章节转节问题：HTML编译正常但PDF无章节显示求助

Let’s walk through targeted fixes for your issue—since HTML and gitbook outputs work fine, the problem is tied to how LaTeX processes your book structure or PDF configuration.

1. Validate Your PDF Output Settings #

First, check your _output.yml to ensure PDF-specific settings are enabling sections and proper rendering. Here’s a recommended base configuration for bookdown::pdf_book:

bookdown::pdf_book:
  toc: true                  # Generates a table of contents
  number_sections: true      # Enables numbering for post-preface chapters
  keep_tex: true             # Critical for debugging—retains the raw .tex file
  latex_engine: xelatex      # Handles Unicode smoothly; pdflatex works too

If number_sections was set to false, it would suppress chapter numbering and might prevent sections from rendering as formal chapters in the PDF.

2. Confirm \mainmatter Placement and Chapter Syntax #

You noted page numbering switches to Arabic numerals at Introduction, so \mainmatter is working for pagination—but we need to ensure formal chapters are recognized as LaTeX sections:

• Make sure your Introduction (and all subsequent chapters) use unmodified heading syntax (no {-} suffix). For example:

  # Introduction
  

  The {-} tells Bookdown to suppress numbering and exclude the heading from the table of contents—accidentally adding it to formal chapters will make them disappear from the PDF’s structured output.
• Verify \mainmatter is placed right after your preface in index.Rmd, with no extra content or formatting between it and your first chapter file. Example:

  # Preface {-}
  
  Your preface content here...
  
  \mainmatter
  

3. Inspect the Generated .tex File #

With keep_tex: true enabled, after compiling the PDF, you’ll find a .tex file in your project folder. Open it and locate your Introduction section:

• It should convert to LaTeX like this:

  \section{Introduction}
  

• If it’s just plain text (no \section command), Bookdown didn’t recognize the heading as a section. Check for typos (e.g., extra spaces before #, using ## instead of # for top-level chapters).

4. Check for LaTeX Compilation Errors #

Silent LaTeX errors (like missing packages) can break chapter rendering. Open the compilation log (found in RStudio’s Build tab or as a .log file alongside the .tex file) and look for lines starting with ! Error. Common issues include:

• Missing LaTeX packages (bookdown usually handles dependencies, but custom templates may require extras like titlesec for section styling).
• Unescaped special characters (e.g., _ or %) in your content that halt compilation.

5. Test with the Default LaTeX Template #

If you’re using a custom LaTeX template in _output.yml, temporarily remove that line to use Bookdown’s default template. Custom templates sometimes omit commands needed to render sections properly with \mainmatter/\frontmatter.

内容的提问来源于stack exchange，提问作者topepo