如何在AsciiDoc中实现随滚动浮动的文本？

针对HTML输出（可行且简单） #

AsciiDoc本身是静态标记语言，原生不支持动态滚动固定，但转成HTML后可以用CSS实现：

• 第一步：在AsciiDoc文档里给需要固定的表头块添加自定义样式类
  示例代码：

  = 你的文档标题
  :stylesheet: custom.css  # 指定自定义样式文件
  
  [.sticky-header]
  == 要固定的表头内容
  ----
  这里填分隔线之间的单个单词
  ----
  
  // 下面是文档正文内容，滚动时上面的表头会固定在顶部
  

• 第二步：创建custom.css文件，添加以下CSS规则：

  .sticky-header {
      position: sticky;
      top: 0;
      background-color: #ffffff;  /* 背景色和页面主体一致，避免遮挡 */
      z-index: 99;
      border-bottom: 1px solid #e0e0e0;
      padding: 0.5rem 0;
  }
  

  生成HTML后，滚动页面时标记了.sticky-header的块会固定在页面顶部。

针对PDF/其他静态文档输出（基本无法实现） #

PDF是静态排版格式，没有滚动交互的动态特性，Asciidoctor转PDF时无法实现“滚动固定表头”这类动态效果，这类场景下该需求不支持。

整体来说，HTML输出的方案非常简单，只需要少量CSS和AsciiDoc的样式标记就能实现；静态文档输出则没有可行方案。

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