MarkDownImageDiy is a straightforward tool to paste images quickly into Markdown files. It works well with Hancel Lin’s “Markdown Image” VS Code extension and supports Hugo sites and SSH remote setups. This guide will help you get it up and running on Windows without any programming skills.
Before installing, make sure your computer meets these basic needs:
- Operating System: Windows 10 or later.
- VS Code Installed: This tool works alongside VS Code. Download it from code.visualstudio.com if you don’t have it yet.
- Basic Keyboard and Mouse Use: You will copy images using keyboard shortcuts or mouse commands.
- Internet Connection: To download the application.
No special hardware or software knowledge is required.
This script lets you paste images into Markdown files in a way that fits perfectly with the Markdown Image VS Code extension. It handles image uploads safely when you work remotely using SSH and supports Hugo page bundles for organizing content.
You can:
- Paste images directly from your clipboard.
- Work with folders formatted for Hugo.
- Use it safely on remote servers via SSH.
- Avoid manual file moves or renaming.
Click the button below to visit the GitHub page where you can download the tool:
Follow these steps once on the page:
- Look for the green button or link that says Code or Releases.
- If you see a release with executable files, click on the
.exeor setup file for Windows. - Save the file to any folder you can remember, like your Desktop or Downloads.
After you download the file, here is what to do:
- Find the file you saved (usually in
Downloads). - Double-click the file to start.
- If a security prompt appears, click More info and then Run anyway.
- Follow any basic setup instructions if given. If not, the file may run immediately.
Once installed, open your Markdown file in VS Code. You’ll use the image paste feature like this:
- Copy an image from anywhere (e.g., a screenshot or a photo).
- In your Markdown document, place the cursor where you want the image.
- Press the paste keyboard shortcut (
Ctrl + V). - MarkDownImageDiy will paste the image into the correct folder and add the Markdown link automatically.
If you use Hugo, images will be saved in the right page bundle folder structure. If you work over SSH, the tool handles file uploads behind the scenes, so you don’t have to worry about manual transfers.
You can customize MarkDownImageDiy to fit your project:
- Image path settings: Change where images get saved.
- File types: Select accepted image formats like PNG or JPG.
- Remote server details: Set your SSH address and folders if working remotely.
- Naming patterns: Define how pasted images get named.
These options are usually set in a simple .json or .config file included with the script. If you want to change something, open that file in a text editor and edit the clear instructions written inside.
If something does not work as expected, try these steps:
- Make sure VS Code is open and your Markdown file is active.
- Check if you copied an image, not text or files.
- Confirm the script runs with appropriate system permissions.
- Review your configuration file for typos or mistakes.
- Restart VS Code or your computer if the tool stops responding.
- Ensure SSH connection details are correct if working remotely.
If you still have trouble, check the Issues section on the GitHub page for help.
- Use clear, simple names for your folders to keep images organized.
- Regularly back up your Markdown and image files.
- Keep VS Code and MarkDownImageDiy updated for the best performance.
- Try pasting images from different sources to see how it handles each case.
- Use the tool on smaller test projects before applying it to big ones.