Link, URL, and Mailto Macro Attributes Reference

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

Attribute Value(s) Example Syntax Comments

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`

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