+++
title = "Example: Image References"
draft = false
+++

This note demonstrates the three image reference scenarios that the pipeline
must handle.


## Scenario 1: External image (URL) {#scenario-1-external-image--url}

An image hosted on the web — ox-hugo passes the URL through as-is and no
local file handling is needed.

{{< figure src="quartz-logo-external.png" link=""https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSkzsTuLOt8esM6enoKwkzqA52G3p9hldlf2g&s"" >}}


## Scenario 2: Local image (same notes directory) {#scenario-2-local-image--same-notes-directory}

An image sitting next to this .org file inside the notes directory.
ox-hugo copies files referenced with a relative path into the Hugo `static/`
assets tree automatically.

{{< figure src="/ox-hugo/quartz-logo.png" caption="<span class=\"figure-number\">Figure 1: </span>Quartz logo (local, same notes dir)" >}}


## Scenario 3: External image (outside notes directory) {#scenario-3-external-image--outside-notes-directory}

An image that lives outside the notes directory entirely — for example a
shared assets folder or a system path. ox-hugo still copies it into `static/`
and rewrites the reference.

{{< figure src="/ox-hugo/external-location-image.png" caption="<span class=\"figure-number\">Figure 2: </span>Quartz logo (outside notes dir)" >}}