Link, URL, and Mailto Macro Attributes Reference

These attributes apply to the link, URL, and mailto (email) macros.

Attribute Value(s) Example Syntax Comments

id

Unique identifier for element in output

https://asciidoctor.org[Home,id=home]

role

CSS classes available to inline elements

https://chat.asciidoc.org[Discuss AsciiDoc,role=teal]

title

Description of link, often show as tooltip.

https://asciidoctor.org[Home,title=Project home page]

window

any

https://chat.asciidoc.org[Discuss AsciiDoc,window=_blank]

The blank window target can also be specified using ^ at the end of the link text.

window
(shorthand)

^

https://example.org[Google, DuckDuckGo, Ecosia^]
https://chat.asciidoc.org[Discuss AsciiDoc^]

opts

Additional options for link creation.

https://asciidoctor.org[Home,opts=nofollow]

Option names include: nofollow, noopener