Skip to main content

settings

Neccessary installation tools​

https://github.com/ account https://www.sourcetreeapp.com/ https://help.obsidian.md/install

step-by-step​

  1. git checkout https://github.com/eternia89/sopjaknot.git
  2. cd to folder
  3. npm install (install node-modules dependency)
  4. npm start (start preview server on localhost:3000)
  5. commit -> push to main

Obsidian mandatory settings​

You need to change a few settings to make Obsidian work seamlessly with Docusaurus.

  1. Open Obsidian Settings Click the gear icon (⚙️) in the bottom-left corner.

  2. Go to "Files & Links" Select this tab from the left-hand menu.

  3. Adjust the Following Settings:

    • Use Wikilinks: Turn this setting OFF. This is the most important step. It tells Obsidian to generate standard ![](...) Markdown links instead of ![[...]] links.

    • Default location for new attachments: Change this to "In subfolder under current folder".

    • Subfolder name: Set this to a name like _assets or images. This will create a neat subfolder for images inside the same folder as your document, which is perfect for Docusaurus.

    • New link format: Set this to "Relative path to file". This ensures the generated link is ./_assets/image.png, which Docusaurus needs.

Your Ideal Settings Summary​

Your "Files & Links" settings should look like this:

  • Use Wikilinks: OFF

  • Default location for new attachments: In subfolder under current folder

  • Subfolder name: _assets

  • New link format: Relative path to file

Now, when you paste an image into a document like docs/my-feature/my-doc.md, Obsidian will automatically:

  1. Create the folder docs/my-feature/_assets/.

  2. Save the image inside it (e.g., Pasted image 20250701165228.png).

  3. Insert the correct, Docusaurus-compatible link: ![[Pasted image 20250701165228.png]] ![](_assets/Pasted%20image%2020250701165228.png).

## How to Fix Existing Broken Links​

For images you've already pasted, you'll need to convert the old Wikilinks to Markdown links.

The easiest way is to use the Command Palette:

  1. Open the Command Palette (Ctrl+P on Windows/Linux, Cmd+P on macOS).

  2. Search for and run the command: "Convert Wikilinks to Markdown links". This will scan the current file and fix all the links for you.