// Tutorial //

How To Add Images in Markdown

Published on June 30, 2016 · Updated on October 12, 2020
    Default avatar

    By Alligator.io

    How To Add Images in Markdown


    You can add images to Markdown using the [alt text](image_url) syntax. Let’s see how it works.


    Adding Images in Markdown

    Here’s the syntax for adding images in Markdown. The title is optional:

    ![Alt text](https://assets.digitalocean.com/articles/alligator/boo.svg "a title")

    This results in the following HTML:

    <img title="a title" alt="Alt text" src="/images/boo.svg">

    Linked Images

    With the markdown syntax for links, here’s how you would have a linked image:

    [![Alt text](https://assets.digitalocean.com/articles/alligator/boo.svg)](https://digitalocean.com)


    The <img> element is a useful feature of HTML.

    For a more comprehensive review of the HTML5 markup language, explore our series, How To Build a Website in HTML.

    Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

    Learn more about us

    About the authors
    Default avatar


    Still looking for an answer?

    Ask a questionSearch for more help

    Was this helpful?

    This textbox defaults to using Markdown to format your answer.

    You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

    If, by any chance, anyone wants to embed (a.k.a. in the same file) images inside a markdown file, they can do it by converting the image to base64 URI (this can help : https://base64.guru/converter/encode/image) and paste the result inside the link section of the image.

    You can check this : https://drive.google.com/file/d/1TB5cRgTHpNN5PtyrpV50yfAGQQym9O89/view?usp=sharing

    as reference.

    Try DigitalOcean for free

    Click below to sign up and get $200 of credit to try our products over 60 days!

    Sign up