Skip to content

Instantly share code, notes, and snippets.

@DavidWells
Last active December 20, 2024 16:34
Show Gist options
  • Save DavidWells/7d2e0e1bc78f4ac59a123ddf8b74932d to your computer and use it in GitHub Desktop.
Save DavidWells/7d2e0e1bc78f4ac59a123ddf8b74932d to your computer and use it in GitHub Desktop.
Guide to aligning images in github readme.md files. https://davidwells.io/snippets/how-to-align-images-in-markdown

Aligning images

This is a guide for aligning images.

See the full Advanced Markdown doc for more tips and tricks

left alignment

This is the code you need to align images to the left:

<img align="left" width="100" height="100" src="https://picsum.photos/100/100">

right alignment

This is the code you need to align images to the right:

<img align="right" width="100" height="100" src="https://picsum.photos/100/100">

center alignment example

<p align="center">
  <img width="460" height="300" src="https://picsum.photos/460/300">
</p>

Markdown Formatting on steriods

If you like this, you might enjoy markdown-magic. I built it to automatically format markdown files and allow folks to sync docs/code/data from external sources.

@ruizlenato
Copy link

image
does anyone have any idea how I can fix this? the Heading line crosses over the image

@cyb3rko
Copy link

cyb3rko commented Mar 20, 2024

@ruizlenato I have seen the same issue in many different repositories now.
Seems like GitHub changed something about the Markdown rendering.

@RitamChakraborty
Copy link

Can this not be fixed with few line breaks? (<br>)


Twittergram

Twittergram

Twittergram is a bot for telegram written in golang using the telego library with localization support (i18n) and some twitter-related functions, such as downloading media and sending it to telegram.

See more at @twittergramrobot or @xgramrobot



Donate — Help keep the project alive and up-to-date.

Donate with Ko-Fi

Licensed under the terms of the GNU General Public License v3 (GPLv3)

@brandonsturgeon
Copy link

Having trouble aligning a small image vertically with my text:

Library Name0/30Easy

Example content

<details>
<summary><a href="https://whatever.com"><code>Library Name</code></a> • <strong><code>0/30</code></strong> • <img alt="Easy" src="https://img.shields.io/badge/Easy-32CD32"></summary>

Example content
</details>

align="middle" does have an effect, but not quite the one I intended...

Library Name0/30Easy

Example content

Making the image smaller seems to make it align better, but then it's too small:

Library Name0/30Easy

Example content

Any advice?

@RitamChakraborty
Copy link

Use align="center"

<details>
    <summary>
        <a href="https://whatever.com"><code>Library Name</code></a>
        <span></span>
        <strong><code>0/30</code></strong>
        <span></span>
        <img align="center" alt="Easy" src="https://img.shields.io/badge/Easy-32CD32">
    </summary>
    Example content
</details>
Library Name 0/30 Easy Example content

@brandonsturgeon
Copy link

I was confused because your post had the same issue as mine, but then I checked on Chrome and it looked good!

half-win; thank you 👍

@yvele
Copy link

yvele commented Sep 11, 2024

Looks to be not working anymore 🤔

image

@azat-io
Copy link

azat-io commented Sep 11, 2024

The same problem. It not woking anymore

@mkingvc
Copy link

mkingvc commented Sep 11, 2024

Same here. Looks like GitHub changed something recently.

@azat-io
Copy link

azat-io commented Sep 11, 2024

Looks like it was fixed

@rahaaatul
Copy link

is there a way to add rounded border outside images?

@bishos123
Copy link

Thanks guys!

@danielvartan
Copy link

👏👏👏

@Sofia-A-Fayo-Freites
Copy link

Thank you. Just what i needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment