如何在R Markdown中添加适配HTML与PDF的可格式化全宽水平规则？

Great question! The default Pandoc horizontal rule (***) behaves inconsistently between HTML and PDF outputs in R Markdown—LaTeX renders it as a centered half-width line by default, which isn't ideal. Let's walk through reliable ways to create full-width rules that work across both formats, plus how to customize their style (color, thickness, etc.):

Method 1: Conditional Raw Blocks (Simple, One-Off Use) #

You can use Pandoc's raw format attributes to target HTML and PDF separately. This lets you write format-specific code that only runs for the output type you're building:

<!-- Full-width HR for HTML -->
```{=html}
<hr style="width: 100%; height: 3px; background-color: #2c3e50; border: none; margin: 1em 0;">

\noindent\rule{\linewidth}{3pt}

- For HTML: The `<hr>` tag with inline styles gives you full control over width, thickness (`height`), color, and spacing.
- For PDF: `\noindent` removes default indentation, `\linewidth` makes the rule span the full text width, and `3pt` sets the thickness.

## Method 2: Reusable Custom Styles (Best for Multiple HRs)
If you need to use the same styled rule multiple times, define global styles in your YAML header and call them throughout your document:

### Step 1: Set Up YAML Header
Add references to a CSS file (for HTML) and a LaTeX preamble (for PDF):
```yaml
---
title: "Custom HR Demo"
output:
  html_document:
    css: hr-styles.css
  pdf_document:
    includes:
      in_header: hr-preamble.tex
---

Step 2: Create CSS File (hr-styles.css) #

Define a custom class for your HTML horizontal rule:

hr.full-width {
  width: 100%;
  height: 2px;
  background-color: #e74c3c;
  border: none;
  margin: 1.5em 0;
}

Step 3: Create LaTeX Preamble (hr-preamble.tex) #

Define a custom command for your PDF rule (add color support with the xcolor package):

\usepackage[html]{xcolor} % Lets you use HTML hex colors
\newcommand{\fullwidthhr}{\noindent\textcolor{HTML}{e74c3c}{\rule{\linewidth}{2pt}}}

Step 4: Use the Custom HR in Your Document #

Call the appropriate style for each format:

```{=html}
<hr class="full-width">

\fullwidthhr

## Method 3: R Code Block (Dynamic, Programmatic Control)
For even more flexibility, use an R code block to output the correct HR based on the current output format. This is great if you want to adjust styles dynamically:

```r
```{r echo=FALSE, results='asis'}
# Define your HR style parameters
hr_params <- list(
  width = "100%",
  thickness = "3px",
  color = "#27ae60",
  margin = "1.5em 0"
)

# Output HTML or LaTeX code based on format
if (knitr::is_html_output()) {
  cat(sprintf(
    '<hr style="width: %s; height: %s; background-color: %s; border: none; margin: %s;">',
    hr_params$width, hr_params$thickness, hr_params$color, hr_params$margin
  ))
} else if (knitr::is_latex_output()) {
  # Load xcolor package for color support
  cat('\\usepackage[html]{xcolor}\n')
  # Convert hex color to LaTeX-compatible format (remove the #)
  latex_color <- gsub("#", "", hr_params$color)
  # Convert CSS thickness (px) to LaTeX pt (1px ≈ 0.75pt)
  latex_thickness <- as.numeric(gsub("px", "", hr_params$thickness)) * 0.75
  cat(sprintf(
    '\\noindent\\textcolor{HTML}{%s}{\\rule{\\linewidth}{%.1fpt}}',
    latex_color, latex_thickness
  ))
}

## Key Customization Tips
- **Thickness**: For HTML, adjust the `height` property of the `<hr>` tag. For LaTeX, change the second argument in `\rule{}{}` (use units like `pt`, `cm`, or `mm`).
- **Color**: For HTML, use any valid CSS color name or hex code. For LaTeX, use the `xcolor` package (with `html` option) to match HTML hex colors, or use predefined LaTeX color names like `red` or `blue`.
- **Spacing**: For HTML, use the `margin` property. For LaTeX, add vertical space before/after the rule with commands like `\vspace{1em}`.

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