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 of
[image name](image external link)
- Want to be able to access large attachments like images through the cloud anytime, anywhere
- Want to share with friends more quickly and conveniently without wasting time copying images
2. Required plugins#
- obsidian-emo-uploader
- Download from github obsidian-emo-uploader
- Or browse and download from the Obsidian community plugins
- If you can't download, leave me a message
3. Method steps#
- You need to have a free github account first
- Register using your email at https://github.com/signup?source=login
- Remember your username and the password you set
- Create a repository on github
- Log in to github with 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 repos under your github account
- Set up the emo-uploader plugin in Obsidian
- Select github 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
- Enter main in branch (note that sometimes the created repo may be the master branch)
- Enter the string of characters starting with ghp that you generated above in token
- Enter a message or generate one from emo-uploader·Github
- Leave path blank, the images will be uploaded to the
images/main
folder- Or enter a subfolder name followed by a slash, such as
2024/
- In this case, the images will be uploaded to the
images/main/2024
folder - 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 drag and drop 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 physical file you want