Asciidoctor Asciidoctor Docs
AsciiDoc
Language Syntax Quick Reference
Processing
Asciidoctor Ruby Asciidoctor.js JavaScript AsciidoctorJ Java
Extensions
Add-on Converters
reveal.js Ruby, JavaScript
Extended Syntax
Asciidoctor Diagram Ruby
Tooling
Build Automation
Maven Tools Java Asciidoclet Java
Text Editors / Viewers
IntelliJ Plugin

AsciiDoc

    • Introduction
      • Document Structure
      • Key Concepts
      • Document Processing
      • Normalization
    • Blocks
      • Build a Basic Block
      • Add a Title to a Block
      • Assign an ID
      • Block Style Attribute
      • Nesting Blocks
      • Masquerading Blocks
      • Troubleshooting Blocks
    • Document Attributes
      • Attribute Entries
        • Attribute Entry Names and Values
        • Wrap Attribute Entry Values
        • Customize Attribute Entry Substitutions
        • Inline Attribute Entries
      • Declare Built-In Attributes
        • Set Boolean Attributes
      • Declare Custom Attributes
      • Unset Attributes
      • Reference Attributes
        • Handle Unresolved References
      • Attribute Assignment Precedence
    • Element Attributes
      • Positional and Named Attributes
      • ID Attribute
      • Options Attribute
      • Role Attribute
    • Document Header
      • Document Title
        • Subtitle
      • Author Information
        • Using the Author Line
        • Add Multiple Authors to a Document
        • Assign Author and Email with Attribute Entries
        • Reference the Author Information
        • Compound Author Names
      • Revision Information
        • Using the Revision Line
        • Assign Revision Attributes with Attribute Entries
        • Version Label Attribute
        • Reference the Revision Attributes
      • Document Metadata
      • Header Reference
    • Document Types
    • Sections
      • Section Titles and Levels
        • Activate Section Title Links
        • Discrete Titles
      • Autogenerated Section IDs
        • Change the ID Prefix and Separator
      • Assign Custom IDs and Reference Text
      • Section Numbers
      • Section Styles for Articles and Books
        • Hide Special Section Titles
        • Number Special Sections
        • Colophon
        • Dedication
        • Abstract (Section)
        • Abstract (Block)
        • Preface
        • Book Parts
          • Number and Label Parts
        • Chapters
        • Appendix
        • Glossary
        • Bibliography
        • Index
      • Section Attributes and Styles Reference
    • Paragraphs
      • Hard Line Breaks
      • Preamble and Lead Style
      • Paragraph Alignment
    • Breaks
    • Text Formatting and Punctuation
      • Bold
      • Italic
      • Monospace
      • Highlight
      • Quotation Marks and Apostrophes
      • Subscript and Superscript
      • Using Custom Inline Styles
      • Troubleshoot Unconstrained Formatting Pairs
    • Lists
      • Unordered Lists
      • Ordered Lists
      • Checklists
      • List Continuation
    • Description Lists
      • Question and Answer Lists
    • Links
      • Autolinks
      • URL Macro
      • Mailto Macro
      • Link Macro
      • Link Macro Attribute Parsing
      • Troubleshooting Complex URLs
      • Link Macro Attributes Reference
    • Cross References
      • Document to Document Cross References
      • Cross Reference Text and Styles
      • Validate Cross References
    • Footnotes
    • Images
      • Set the Images Directory
      • Insert Images from a URL
      • Position and Frame Images
      • Adjust Image Sizes
      • SVG Images
      • Images Reference
    • Audio and Video
    • Icons
      • Image Icons Mode
      • Font Icons Mode
      • Icon Macro
    • Keyboard Macro
    • Button and Menu UI Macros
    • Admonitions
    • Sidebars
    • Example Blocks
    • Blockquotes
    • Verses
    • Verbatim and Source Blocks
      • Source Code Blocks
        • Source Highlighting
        • Highlight Select Lines
        • Highlight PHP Source Code
      • Listing Blocks
      • Literal Blocks
      • Callouts
    • Tables
      • Build a Basic Table
      • Add a Title
        • Customize the Title Label
        • Turn off the Title Label
      • Add Columns to a Table
        • Adjust Column Widths
        • Align Content by Column
        • Format Content by Column
      • Add Cells and Rows to a Table
        • Create a Header Row
        • Create a Footer Row
        • Align Content by Cell
        • Format Content by Cell
        • Span Columns and Rows
        • Duplicate Cells
      • Table Width
      • Table Borders
      • Table Striping
      • Table Orientation
      • Assign a Role to a Table
      • Nesting Tables
      • CSV, TSV and DSV Data
      • Table Reference
    • Equations and Formulas
    • Counters
    • Open Blocks
    • Comments
    • Automatic Table of Contents
      • Customize the TOC Title
      • Change the Section Level Depth
      • Position the TOC
      • TOC Attributes Reference
    • Includes
      • Offset Section Levels
      • Indent Included Content
      • Use an Include File Multiple Times
      • Include List Item Content
      • Include Content by Tagged Regions
      • Include Content by Line Ranges
      • Include Content by URI
    • Conditionals
      • ifdef and ifndef Directives
      • ifeval Directive
    • Substitutions
      • Special Characters
      • Quotes
      • Attribute References
      • Character Replacements
      • Macros
      • Post Replacements
      • Customize the Substitutions Applied to Blocks
      • Customize the Substitutions Applied to Text
      • Escape and Prevent Substitutions
    • Passthroughs
      • Inline Passthroughs
      • Passthrough Blocks
    • Compare AsciiDoc and Markdown
    • Reference
      • Syntax Quick Reference
      • Document Attributes Reference
      • Character Replacement Attributes Reference
      • Glossary of Terms
AsciiDoc
  • AsciiDoc
  • Asciidoctor
    • 2.0
  • Asciidoctor.js
    • 2.2
  • AsciidoctorJ
    • 2.4
  • Maven Tools
    • 2.1
  • Asciidoclet
    • 1.5.6
  • Asciidoctor reveal.js
    • 4.1
  • Asciidoctor EPUB3
    • 1.5
  • Asciidoctor Diagram
    • 2.0
  • Community
  • AsciiDoc
  • Blocks
  • Masquerading Blocks
Edit this Page

Masquerading Blocks

Some blocks can masquerade as other blocks, a feature which is controlled by the block style attribute.

Nesting Blocks Troubleshooting Blocks
Asciidoctor
Asciidoctor
  • Home
  • Docs
  • Source
  • Discuss

Copyright © 2021 Dan Allen, Sarah White, and individual Asciidoctor contributors. Except where noted, the content is licensed under a Creative Commons Attribution 4.0 International (CC BY 4.0) license.

The UI for this site is based on the default Antora UI and is licensed under the MPL-2.0 license. Several icons are imported from Octicons and are licensed under the MIT license.

AsciiDoc is a Trademark of the Eclipse Foundation, Inc.

Thanks to our backers and contributors for helping to make this project possible. Additional thanks to:

OpenDevise Logo Algolia logo Deploys by Netlify

Authored in AsciiDoc.
Produced by Antora and Asciidoctor.