Wiki-style links (![[%text%]]) are messing up the GitLab and similar systems

Steps to reproduce

  1. Create a Vault, create a note named Readme.md (or README.md or readme.md) in the root.
  2. Paste an image in this readme using ![[image_name]] notation.
  3. Push the vault to Github or Gitlab repo.

Expected result

Images are displayed correctly on the webpage of the repository.

Actual result

Image links are decoded as missing Wiki pages on those resources.

Environment

Any

Additional information

If I use a dedicated markdown tag for images (text)[image_file], which works for websites capable of showing markdown documents, Obsidian won’t display the image, instead displaying the tag as a document link (which is obviously not existing in the vault).

So for all it seems Obsidian has just swapped the meaning of URL and Image tags it its layout: Wiki page tag is used as image and image/URL tag is used as page link.

markdown style links do work, e.g:

![test.png](../../../test.png) displays an embedded image for me

You can also configure obsidian to use them by default under Options | File and Links. Un-check use wikilinks, and set the format as desired (shortest path, relative path, absolute path)

1 Like

Oh thanks! Can I put the configuration in the vault itself so that the team would have it working too?

AFAIK all of the configuration settings are stored in the .obsidian folder inside the vault (these are the files such as app.json, appearance.json, etc…).

If you’re using obsidian sync, you can choose whether or not to sync Obsidian’s settings in the sync settings

I guess gitignore would do the job, the issue is I would be forcing everyone with my config as default.