1. Applicable scenarios#
- Want to keep the Obsidian library in pure md format
- Don't want to directly put large attachments like images into the Obsidian library
- Want to achieve seamless embedding of images in the format
[image name](image link)
- Want to be able to access large attachments such as images through the cloud anytime, anywhere
- Want to share with friends more quickly and conveniently instead of wasting time copying images
2. Required plugins#
- obsidian-emo-uploader
- You can download obsidian-emo-uploader from GitHub
- Or browse and download from the Obsidian community plugins
- If you are unable to download, you can leave me a message
3. Method steps#
- You need to have a free GitHub account first
- Register from https://github.com/signup?source=login using your email
- Take note of your username and the password you set
- Create a repository on GitHub
- Log in to GitHub using your registered account and password
- Click on the dashboard in the upper left corner
- Click on new
- Choose your account as the owner
- Enter a name for the repository, such as
images
- Check public
- Click on create repository below
- You have now created a repository named images
- Create a token, which is a password token
- Click on the profile icon in the upper right corner
- Click on settings
- Click on developer settings in the lower left corner
- Click on personal access tokens on the left and select tokens (classic)
- Click on generate new token and select generate new token (classic) below
- Enter a description in the note, such as image library
- Select no expiration for Expiration
- Check repo below
- Click on generate token below
- Copy and save the generated token for later use (it may start with ghp followed by a string of characters)
- Note that this token can manage all the repos under your GitHub account
- Set up the emo-uploader plugin in Obsidian
- Choose GitHub as the target hosting in target hosting
- Enter the username of your GitHub account in owner, note that it is not the registered email
- Enter the name of the repository you created on GitHub, such as
images
, in repo - Enter main in branch (note that sometimes the created repo may be on the master branch)
- Enter the string of characters starting with ghp that you generated earlier in token
- Enter a message or generate one from emo-uploader·Github in message
- Leave path empty, the images will be uploaded to the
images/main
folder- Or enter a subfolder name followed by a slash, such as
2024/
- The images will be uploaded to the
images/main/2024
folder in this case - The latter is preferred for easier management of images by year
- Or enter a subfolder name followed by a slash, such as
- Random filename can be checked
- It can be unchecked if you can ensure that the uploaded images do not have duplicate names
- Keep the default raw or choose another option for cdn
- Embedding images
- Or directly drag the image into the note
- Or copy the image and paste it into the note
- Note: The image will not be moved to the library
- Only a standard MD format link will be embedded in the note and can be previewed directly
4. Other uses#
- Embedding PDF documents
- Embedding audio and video
- Embedding any entity files you want