What happens when you convert MD to JPG
- The Markdown is read by pandoc, the open-source document converter, on our conversion server: headings, lists, tables, links, emphasis, code blocks, quotes and footnotes are turned into a web page with pandoc's clean default style, and Chromium, the open-source browser behind Chrome, captures it as one tall image 1,280 pixels wide, the width of a laptop window. A page taller than 16,384 pixels is cut off at that point, and a short page still makes an image at least 900 pixels tall. The JPG is saved at 92 percent quality.
- The converter reads nothing but the file itself, so images linked from it are left out; only images embedded in the file as data URIs are kept. Raw HTML inside the file is dropped.
- Fonts come from the server: DejaVu, Liberation and Noto, which cover most alphabets, including Chinese, Japanese and Korean.
- This conversion runs on our server: the file is uploaded, converted, and deleted together with the result as soon as the result has been sent back to you. Nothing is kept. Files up to 25 MB are accepted.
How to convert MD to JPG online
- Press "Choose MD files" and select one or more files, or drag them onto the box. Files up to 25 MB each can be converted.
- There are no settings to choose: the converter keeps everything the target format can hold.
- Press "Convert to JPG". The file is uploaded to our conversion server, converted in a few seconds, and deleted together with the result as soon as the result is sent back.
- Save each JPG with its download button. Our server has already deleted both your MD and the JPG by then.
Why convert MD to JPG?
MD files usually come from documentation, README files, notes and blogging tools. People convert them to JPG because JPG opens everywhere and keeps photos small, which is why upload forms and email favour it.
In short, MD is good at what it was made for, and JPG is the more practical choice when the file has to open, upload or print somewhere else. MD shows as plain text in browsers; editors such as Obsidian, Typora and VS Code render it, while JPG opens in every browser and image viewer.
How to convert MD to JPG on Windows, Mac, iPhone and Android
On Windows
Open this page in Chrome, Edge or Firefox, drag your MD files in from File Explorer, and press Convert. Each JPG is saved to your Downloads folder.
On a Mac
Safari, Chrome and Firefox all work. Drag the MD files from Finder onto the drop zone and the JPG files land in Downloads.
On iPhone and iPad
Open the page in Safari and tap Choose MD files. You can pick from Photos or from the Files app. The converted JPG appears in Files, in the Downloads folder; to put it in your photo library, open it there, tap Share and choose Save Image.
On Android
Open the page in Chrome, tap Choose MD files and pick them from Files or your gallery. The JPG is saved to the Download folder, where any file manager can find it.
Best settings for MD to JPG
There are no settings: the page is rendered 1,280 pixels wide and captured from top to bottom, up to 16,384 pixels tall.
Embed any pictures in the MD as data URIs if they must appear; linked images are not fetched, by design.
MD vs JPG: the differences
| MD | JPG | |
|---|---|---|
| Full name | Markdown | Joint Photographic Experts Group image |
| Type | document | image |
| Created by | John Gruber | the Joint Photographic Experts Group |
| First released | 2004 | 1992 |
| Compression | Lossless | Lossy |
| Transparency | n/a | No |
| Animation | n/a | No |
| Vector or raster | n/a | Raster |
| Colour | n/a | 24-bit colour, 16.7 million colours |
| What it holds | plain text with simple symbols for headings, lists, links and emphasis | 24-bit colour, 16.7 million colours |
| In a browser | shows as plain text in browsers; editors such as Obsidian, Typora and VS Code render it | opens in every browser and image viewer |
| Common uses | documentation, README files, notes and blogging tools | camera photos, web images and email attachments |
| MIME type | text/markdown | image/jpeg |
About MD and JPG files
What is an MD file?
Markdown marks formatting with plain characters: # for headings, * for lists and emphasis. It reads naturally as text and converts cleanly to HTML, which is why developers and note apps use it.
What is a JPG file?
JPG discards fine detail the eye is least sensitive to, which is why a photo shrinks to a tenth of its raw size but text and sharp edges pick up blocky artefacts. Every re-save at a lossy setting throws away a little more.
MD to JPG not working? Common problems
- "Files up to 25 MB can be converted." Server conversions have a size limit. Compress the images inside the file, or split it, and try again.
- "The conversion took too long and was stopped." Very long or complex files can pass the 90 second limit. Split the file and convert the parts.
- "This file is not really in MD format." The converter checks every file before it runs anything, so a file of another format renamed to .md is refused. Choose the page for its real format.
Convert MD to JPG from the command line
pandoc and Chromium do the same on your own computer:
pandoc input.md -s -o doc.html
chromium --headless --screenshot=output.jpg --window-size=1280,2000 doc.htmlConverting on your own computer keeps the file entirely local, which is worth it for very large or very sensitive documents. For everything else, the converter on this page does it without installing anything.
MD to JPG converter FAQ
Will I lose quality converting MD to JPG?
The image is exactly what a browser window 1,280 pixels wide shows, with slight JPG softness around small text; choose PNG for crisp text.
Why is the JPG a different size from the MD?
The JPG stores every pixel of the rendered page, so it is much larger than the MD and grows with the length of the text.
Are my MD files uploaded?
Yes, for this conversion. A faithful MD to JPG conversion needs pandoc and Chromium, two open-source tools, which cannot run in a browser. The file travels over an encrypted connection, is converted in a private temporary folder, and is deleted together with the JPG as soon as the result has been sent back to you. We do not keep, read or share it.
Can I convert several MD files to JPG at once?
Yes. Select or drop as many files as you like; they are converted one after another and each gets its own download button.
How do I open a JPG file?
JPG opens in every browser and image viewer. JPG is common for camera photos, web images and email attachments.
Is this MD to JPG converter free?
Yes. There is no sign-up and no watermark. Because this conversion uses our server, there is a fair-use limit of 25 MB per file and a number of files per hour, which stops the service being overloaded.
Can I convert MD to JPG on my phone?
Yes. It works in Safari on iPhone and iPad and in Chrome on Android. The conversion happens on our server, so it is as fast on a phone as on a computer; the JPG is saved to your Downloads folder.