I just got started with Markdown. I love it, but there is one thing bugging me: How can I change the size of an image using Markdown?
The documentation only gives the following suggestion for an image:
If it is possible I would like the picture to also be centered. I am asking for general Markdown, not just how GitHub does it.
You could just use some HTML in your Markdown:
<img src="drawing.jpg" alt="drawing" width="200"/>
Or via style attribute (not supported by GitHub)
<img src="drawing.jpg" alt="drawing" style="width:200px;"/>
Or you could use a custom CSS file as described in this answer on Markdown and image alignment
CSS in another file:
img[alt=drawing] { width: 200px; }
The accepted answer here isn't working with any Markdown editor available in the apps I have used till date like Ghost, Stackedit.io or even in the StackOverflow editor. I found a workaround here in the StackEdit.io issue tracker.
The solution is to directly use HTML syntax, and it works perfectly:
<img src="http://....jpg" width="200" height="200" />
If you are writing MarkDown for PanDoc, you can do this:
{ width=50% }
This adds style="width: 50%;" to the HTML <img> tag, or [width=0.5\textwidth] to \includegraphics in LaTeX.
Source: http://pandoc.org/MANUAL.html#extension-link_attributes
Maybe this has recently changed but the Kramdown docs show a simple solution.
From the docs
Here is an inline {:height="36px" width="36px"}.
And here is a referenced ![smile]
[smile]: smile.png
{: height="36px" width="36px"}
Works on github with Jekyll and Kramdown.
Combining two answers I came out with a solution, that might not look that pretty,
but It works!
It creates a thumbnail with a specific size that might be clicked to brings you to the max resolutions image.
[<img src="image.png" width="250"/>](image.png)
Here's an example! I tested it on Visual Code and Github.
Thanks for feedback we know that this also works on:
One might draw on the alt attribute that can be set in almost all Markdown implementations/renderes together with CSS-selectors based on attribute values. The advantage is that one can easily define a whole set of different picture sizes (and further attributes).
Markdown:
CSS:
img[alt="minipic"] {
max-width: 20px;
display: block;
}
If you are using kramdown, you can do this:
{:.foo}
Then add this to your Custom CSS:
.foo {
text-align: center;
width: 100px;
}
Building on from Tiemes answer, if you're using CSS 3 you can use a substring selector:
This selector will match any image with an alt tag that ends with '-fullwidth':
img[alt$="-fullwidth"]{
width: 100%;
display: block;
}
Then you can still use the alt tag for its intended purpose to describe the image.
The Markdown for the above could be something like:
I've been using this in Ghost markdown, and it has been working well.
If you are using reference style images in Gihub Flavored Markdown:
Here is an image of tree:
![alt text][tree]{height=400px width=500px}
[//]: # (Image References)
[tree]: ./images/tree.png "This is a tree"
I came here searching for an answer. Some awesome suggestions here. And gold information pointing out that markdown supports HTMl completely!
A good clean solution is always to go with pure html syntax for sure. With the tag.
But I was trying to still stick to the markdown syntax so I tried wrapping it around a tag and added whatever attributes i wanted for the image inside the div tag. And it WORKS!!
<div style="width:50%"></div>
So this way external images are supported!
Just thought I would put this out there as it isn't in any of the answers. :)
For those intereseted in an rmarkdown and knitr solution. There are some ways to resize images in an .rmd file without the use of html:
You can simply specify a width for an image by adding {width=123px}. Don't introduce whitespace in between the brackets:
{width=250px}
Another option is to use knitr::include_graphics:
```{r, fig.cap="image description", out.width = '50%'}
knitr::include_graphics('your-image.png')
```
You could use this one as well with kramdown:
markdown
{:.some-css-class style="width: 200px"}
or
markdown
{:.some-css-class width="200"}
This way you can directly add arbitrary attributes to the last html element. To add classes there is a shortcut .class.secondclass.
I scripted the simple tag parser for using a custom-size img tag in Jekyll.
https://gist.github.com/nurinamu/4ccf7197a1bdfb0d7079
{% img /path/to/img.png 100x200 %}
You can add the file to the _plugins folder.
I know that this answer is a bit specific, but it might help others in need.
As many photos are uploaded using the Imgur service, you can use the API detailed here to change the size of the photo.
When uploading a photo in a GitHub issue comment, it will be added through Imgur, so this will help a lot if the photo is very big.
Basically, instead of http://i.imgur.com/12345.jpg, you would put http://i.imgur.com/12345m.jpg for medium sized image.
For R-Markdown, neither of the above solutions worked for me, so I turned to regular LaTeX syntax, which works just fine.
\begin{figure}
\includegraphics[width=300pt, height = 125 pt]{drawing.jpg}
\end{figure}
Then you can use e.g. the \begin{center} statement to center the image.
For all looking for solutions which work in R markdown/ bookdown, these of the previous solutions do/do not work or need slight adaption:
Append { width=50% } or { width=50% height=50% }
{ width=50% }{ width=50% height=50% }
Important: no comma between width and height – i.e. { width=50%, height=30% } won't work!
Append { height="36px" width="36px" }
{ height="36px" width="36px" }{:height="36px" width="36px"} with colon, as from @sayth, seems not to work with R markdown=WIDTHxHEIGHT
=WIDTHxHEIGHT  nor =WIDTH only  workWhen using Flask (I am using it with flat pages)... I found that enabling explicitly (was not by default for some reason) 'attr_list' in extensions within the call to markdown does the trick - and then one can use the attributes (very useful also to access CSS - class="my class" for example...).
FLATPAGES_HTML_RENDERER = prerender_jinja
and the function:
def prerender_jinja(text):
prerendered_body = render_template_string(Markup(text))
pygmented_body = markdown.markdown(prerendered_body, extensions=['codehilite', 'fenced_code', 'tables', 'attr_list'])
return pygmented_body
And then in Markdown:
{: width=200px}
I'm using jupyter_core-4.4.0 & jupyter notebook.
attachment links don't work:<img src="attachment:Screen%20Shot%202019-08-06%20at%201.48.10%20PM.png" width="500"/>
Just add div brackets.
<div>
<img src="attachment:Screen%20Shot%202019-08-06%20at%201.48.10%20PM.png" width="500"/>
</div>
Hope this helps!
For future reference:
Markdown implementation for Joplin allows controlling the size of imported images in the following manner:
<img src=":/7653a812439451eb1803236687a70ca" width="450"/>
This feature was requested here and as promised by Laurent this has been implemented.
It took me a while to figure the Joplin specific answer.
The addition of relative dimensions to the source URL will be rendered in the majority of Markdown renderers.
We implemented this in Corilla as I think the pattern is one that follows expectations of existing workflows without pushing the user to rely on basic HTML. If your favourite tool doesn't follow a similar pattern it's worth raising a feature request.
Example of syntax:
Example of kitten:
The sheer <img ... width="50%"> said above, did work on my Github Readme.md document.
However my real issue was, that the image was inside a table cell, just compressing the text in the beside cell. So the other way was to set columns width in Markdown tables, but the solutions did not really seem enough markdownish for my morning.
At last I solved both problems by simply forcing the beside text cell with as much "& nbsp;" as I needed.
I hope this helps. Bye and thanks everybody.
For IntelliJ IDEA users, please refer to Markdown Navigator plugin.
Preview renders images, badges, HTML, etc.
Tieme's answer is best for most cases.
In my case, I am using pandoc to convert markdown to latex. HTML tags won't work here.
My solution is to re-implement \includegraphics
\let\maxincludegraphics\includegraphics
\renewcommand{\includegraphics}[1]{\maxincludegraphics[max width=\textwidth]{#1}}
The is analogous to using CSS after a conversion to HTML.
