生成PDF时如何让段落与PlantUML图同页及强制段落同页？

通用强制多段内容同页的方法 #

1. 使用needspace包（推荐） #

这个包会提前检查当前页剩余空间，若不足以容纳指定高度的内容，自动在内容前插入分页符，完全替代手动插分页符的繁琐操作。

• 先导入包：

\usepackage{needspace}

• 在需要同页的内容块前，根据段落+图表的总高度设置预留空间：

\needspace{6cm} % 预留6cm空间，可根据实际内容高度调整
这是PlantUML图表的描述段落，会和下方图表在同一页展示。

\includegraphics{your-plantuml-diagram.pdf}

当文本增删改导致页面布局变化时，LaTeX会自动重新判断是否需要分页，无需手动调整。

2. 使用minipage环境 #

把需要同页的内容包裹在minipage中，强制LaTeX将其视为一个整体排版，若整体内容超过一页会报错，适合确定内容不跨页的场景：

\begin{minipage}{\textwidth}
图表描述文本，确保和下方图表同页。

\includegraphics{your-diagram.pdf}
\end{minipage}

3. 使用samepage环境 #

这个环境会尝试让内部内容不被分页，若内容过长仍会拆分，但短内容能保证同页，用法更宽松：

\begin{samepage}
图表相关描述...

\includegraphics{your-diagram.pdf}
\end{samepage}

PlantUML图表的针对性优化 #

除通用方法外，可通过调整图表尺寸减少分页概率：

• 在includegraphics中缩放图表：

\includegraphics[width=0.9\textwidth]{your-plantuml-output.pdf}

• 若直接在LaTeX中编写PlantUML代码，可结合minipage或needspace使用：

\needspace{5cm}
以下是系统流程的PlantUML图表：

\begin{plantuml}
@startuml
participant User
participant System
User -> System: 请求数据
System --> User: 返回结果
@enduml
\end{plantuml}

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