Attachments are downloadable resources, such as PDFs or the ZIP archives of sample projects, that are stored in an xref:ROOT:attachments-directory.adoc[_attachments_ family directory].
Although not as common, an example file can be promoted to an attachment to make it downloadable as well.
You create links to attachments using the xref macro.
Although not as common, an example file can be reclassified as an attachment to make it downloadable as well.
Unlike images, attachments cannot be inserted directly into a page.
Images are source files, such as photographs, diagrams, and screenshots, that are stored in an xref:ROOT:images-directory.adoc[_images_ family directory].
An image can be inserted into any page or partial, regardless of the module or component version it belongs to, using an AsciiDoc image macro.
AsciiDoc supports PNG, JPG, SVG, and GIF (static and animated) image file formats.
AsciiDoc supports the PNG, JPG, SVG, and GIF (static and animated) image file formats.
It's also possible to create a link to an image using the xref macro.
