Documentation/content/advanced/images-in-wiki-pages.md

eleventyNavigation
key title parent ThirdPartyTools Including images in wiki pages AdvancedUsage

Uploading images via git

Currently, Gitea supports only images in the base directory of the wiki git. (Gitea wiki pages are stored in a separate wiki right beside the project, wiki pages themselves are markdown files).

A feasible workflow might look like this (replace <user> and <project> with your user and project name):

git clone git@codeberg.org:<user>/<project>.wiki.git
cd <project>.wiki.git
## now copy image file into this folder
git add <codeberg.png>
git commit -m "add image"
git push

Now, you can reference the image in Markdown, like this:

![image alt text](codeberg.png "image title")

After saving your changes, the image should be visible.

NOTE: In contrast to embedding external images, images in git are only rendered after saving the wiki or markdown file changes.