// Tutorial //

How To Add Images in Markdown

Published on June 30, 2016 · Updated on October 12, 2020
    Default avatar
    By Alligator.io
    Developer and author at DigitalOcean.
    How To Add Images in Markdown

    Introduction

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

    Prerequisites

    Adding Images in Markdown

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

    document.md
    ![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:

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

    Conclusion

    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.


    Want to learn more? Join the DigitalOcean Community!

    Join our DigitalOcean community of over a million developers for free! Get help and share knowledge in our Questions & Answers section, find tutorials and tools that will help you grow as a developer and scale your project or business, and subscribe to topics of interest.

    Sign up
    About the authors
    Default avatar
    Developer and author at DigitalOcean.

    Default avatar
    Developer and author at DigitalOcean.

    Still looking for an answer?

    Was this helpful?

    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.