如何在RMarkdown/Quarto生成的HTML网站中使用瑞士引号

架构老林

2026-8-3

解决Quarto文档中瑞士引号（«text»）不生效的问题

问题根源

你写的CSS样式是针对HTML的<q>标签，但Markdown默认不会将普通双引号" "转换为<q>元素，所以样式根本没作用到你的文本引号上，导致始终显示英文引号。

可行解决方案

方案一：手动使用`<q>`标签

直接在index.qmd里用<q>标签包裹需要加引号的文本，让CSS样式生效：

# Quotation Test

<q>Quotation please!</q>

渲染后会生成<q>元素，匹配你定义的CSS规则，显示瑞士引号。

方案二：用Lua过滤器自动转换双引号

添加Lua过滤器，让Markdown中的普通双引号自动转为<q>标签，无需手动修改文本：

在项目根目录创建quotes-to-q.lua文件，内容如下：

function Inline(elem)
  if elem.t == "DoubleQuote" then
    return pandoc.RawInline("html", "<q>" .. elem.content .. "</q>")
  end
  return elem
end

修改_quarto.yml，添加过滤器配置：

project:
  title: "quotes"

book: 
  chapters: 
    - index.qmd
  
format: 
  html:
    lang: de-CH
    css: style.css
    filters:
      - quotes-to-q.lua

之后你在index.qmd里写的普通双引号会被自动转为<q>标签，应用瑞士引号样式。

方案三：CSS直接替换文本引号（局限性较大）

如果不想用<q>标签，可尝试用CSS伪元素替换文本中的双引号，但兼容性和精确性不如前两种方案：
修改styles.css内容：

html[lang="de-CH"] p {
  quotes: '«' '»' '‹' '›';
}
html[lang="de-CH"] p:before {
  content: open-quote;
}
html[lang="de-CH"] p:after {
  content: close-quote;
}

注意：这种方法会给整个段落添加引号，仅适合单一段落只有一处引号的场景。