Sidebar Blocks

Basic Example

[sidebar]
Sidebars are used to visually separate auxiliary bits of content that supplement the main text.

Result

Sidebars are used to visually separate auxiliary bits of content that supplement the main text.

Delimited Examples

.Download source code
****
You can download the initial source for this section link:yourURL[here] +
(includes code from the previous step).
The completed source code for this section can be downloaded link:yourURL[here].
****

Result

Download source code

You can download the initial source for this section here
(includes code from the previous step). The completed source code for this section can be downloaded here.

And a more complex example:

.Download source code
****
You can download the initial source for this section link:yourURL[here] +
(includes code from the previous step).
The completed source code for this section can be downloaded link:yourURL[here].

TIP: They can contain any type of content.

.Source code block in a sidebar
[source,js]
----
const { expect, expectCalledWith, heredoc } = require('../../../test/test-utils')
----
****

Result

Download source code

You can download the initial source for this section here
(includes code from the previous step). The completed source code for this section can be downloaded here.

They can contain any type of content.
Source code block in a sidebar
const { expect, expectCalledWith, heredoc } = require('../../../test/test-utils')