如何在ASCIIDOC中双列渲染代码及表格行内嵌代码块？

一、双列布局渲染代码 #

借助Asciidoc的列布局特性，通过表格的cols属性就能实现双列并排渲染代码块，具体示例如下：

[cols="a,a"]
|===
| 左侧代码区 | 右侧代码区

[source,java]
----
public class DemoLeft {
    public static void main(String[] args) {
        System.out.println("左侧双列代码");
    }
}
----
|
[source,python]
----
def demo_right():
    print("右侧双列代码")

demo_right()
----
|===

cols="a,a"表示两列按等宽分配空间，每列单元格内独立嵌入[source]代码块，最终渲染后左右代码会并排展示。

二、将[source]代码块嵌入两列表格同一行 #

要在两列表格的同一行中嵌入代码块，只需在对应行的单元格内直接放置[source]代码块即可，示例如下：

[cols="a,a"]
|===
| 代码示例 | 说明文本

|
[source,javascript]
----
const handleClick = () => {
    console.log("同一行内的代码块");
};
----
| 这是与代码块同属一行的说明文本

| 另一行代码 | 另一行说明
|
[source,go]
----
func main() {
    fmt.Println("表格同一行的代码")
}
----
| 这是第二行的说明内容
|===

表格的每一行通过|分隔单元格，代码块会被渲染在所属行的对应单元格中，实现同一行内代码与文本或代码与代码的组合展示。

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