# 四开本创作 > 该技能基于Quarto CLI v1.8.26。 ## 何时使用什么任务：编写一个新的四开文档使用：按照下面的“QMD Essentials”进行操作，然后查看具体的参考文件任务：将 R Markdown 转换为四开使用：[references/conversion-rmarkdown.md]() 任务：迁移 bookdown 项目使用：[references/conversion-bookdown.md]() 任务：迁移 xaringan 幻灯片使用：[references/conversion-xaringan.md]() 任务：迁移 distill 文章使用：[references/conversion-distill.md]() 任务：迁移 blogdown 站点使用：[references/conversion-blogdown.md]() 任务：添加交叉引用使用：[references/cross-references.md]() 任务：配置代码单元使用：[references/code-cells.md]() 任务：添加带有标题的图形使用：[references/figures.md]() 任务：创建表使用：[references/tables.md]() 任务：添加引文和参考书目使用：[references/itations.md]() 任务：添加标注块使用：[references/callouts.md]() 任务：添加图表（Mermaid、Graphviz）使用：[references/diagrams.md]() 任务：控制页面布局使用：[references/layout.md]() 任务：使用短代码使用：[references/shortcodes.md]() 任务：添加条件内容使用：[references/conditional-content.md]() 任务：使用 div 和 span 使用：[references/divs-and-spans.md]() 任务：配置 YAML front Matter 使用：[references/yaml-front-matter.md]() 任务：查找并使用扩展使用：[references/extensions.md]() 任务：应用 markdown linting 规则使用：[references/markdown-linting.md]() ## QMD 要点 ### 基本文档结构 --- title: “文档标题” 作者：“作者姓名” 日期：今天格式： html --- 内容在这里。四开文档由两个主要部分组成： 1. **YAML Front Matter** ：元数据和配置位于顶部，用 `---` 括起来。 2. **Markdown 内容** ：使用标准 Markdown 语法的主体。 ### Div 和 Span Div 使用带有三个冒号的围栏语法： ::: {.类名} div 内的内容。 ::: Span 使用括号语法：这是[重要文字]{.highlight}。详细信息：[references/divs-and-spans.md]() ### 代码单元格选项语法代码单元以三个反引号和大括号之间的语言标识符开头。代码单元是可以执行以产生输出的代码块。 Quarto 使用语言的注释符号 + `|` 作为单元格选项。选项使用**破折号，而不是点**（例如，“fig-cap”而不是“fig.cap”）。 * R、Python：`#|` * 美人鱼：`%%|` * Graphviz/DOT：`//|` ````{r} #|标签：无花果示例 #|回声：假 #| Fig-cap：“散点图示例。” 绘图（x，y） ```` 常见的执行选项：选项 |描述 |价值观 ---|---|--- `评估` |评估代码 | ‘真’、‘假’ `回声` |显示代码 | “真”、“假”、“围栏” `输出` |包括输出 | ‘真’、‘假’、‘asis’ `警告` |显示警告 | ‘真’、‘假’ `错误` |显示错误 | ‘真’、‘假’ `包括` |包含在输出中 | ‘真’、‘假’ 在 YAML Front Matter 中设置文档级默认值：执行：回声：假警告：错误详细信息：[references/code-cells.md]() ### 交叉引用标签必须以类型前缀开头。使用“@”引用： * 图：`fig-`前缀，例如`#|标签：无花果图`→`@无花果图` * 表：`tbl-` 前缀，例如`#|标签：tbl-data`→`@tbl-data` * 部分： `sec-` 前缀，例如 `{#sec-intro}` → `@sec-intro` * 方程： `eq-` 前缀，例如 `{#eq-model}` → `@eq-model` ````{r} #|标签：无花果图 #| Fig-cap：“情节的标题。” 情节(1) ```` 有关结果，请参阅@fig-plot。详细信息：[references/cross-references.md]() ### 标注块五种类型：“注意”、“警告”、“重要”、“提示”、“注意”。 ::: {.callout-note} 这是注释标注。 ::: ::: {.callout-警告} ## 自定义标题这是带有自定义标题的警告。 ::: 详细信息：[references/callouts.md]() ### 人物 ![标题文字](image.png){#fig-name Fig-alt="替代文字"} 子图： ::: {#fig-group 布局-ncol=2} ![副标题 1](image1.png){#fig-sub1} ![副标题 2](image2.png){#fig-sub2} 该组的主要标题。 ::: 详细信息：[references/figures.md]() ### 表格 ::: {#tbl-示例} |第 1 栏 |第 2 栏 | | -------- | -------- | |数据1 |数据2 | 表格标题。 ::: 详细信息：[references/tables.md]() ### 引文根据@smith2020，结果显示...... 多次引用[@smith2020; @jones2021]。在 YAML 中配置：参考书目：references.bib csl：apa.csl 详细信息：[references/itations.md]() ## 常见工作流程 ### 创建 HTML 文档标题：《我的报告》作者：《你的名字》日期：今天格式： html: 目录：正确代码折叠：true 主题：宇宙 ### 创建 PDF 文档标题：《我的报告》格式： pdf: 文档类：文章纸张尺寸：a4 ### 创建 RevealJS 演示文稿 --- 标题：《我的演讲》格式：revealjs --- ## 第一张幻灯片内容在这里。 ## 第二张幻灯片更多内容。 ### 设置四开本项目在项目根目录中创建“_quarto.yml”：项目：类型：网站网站：标题：“我的网站” 导航栏：左： - href:index.qmd 文字：首页 - href: about.qmd 文字：关于格式： html: 主题：宇宙 ## 资源 * [Quarto 文档]() * [四开本指南]() * [四开扩展]() * [社区扩展列表]()

四开本创作

包含技能