BETA

Skip links

  • Skip to primary navigation
  • Skip to content
  • Skip to footer
Queensland government logo Queensland government logo
Sign in Sign out
Sign in
  • Profile summary
  • Sign out
Department of Education Department of Education Developer Portal
  • Home
  • Tags
  • Chat
  • New
    APIs
  • Help
  • Contact us
  • Dark mode
  • Home
  • Tags
  • Chat
  • New
    APIs
  • Help
  • Contact us
  • My profile
  • Dark mode

Adding images to posts using the markdown editor

Sushma Hazari Government Certified Admin
by Sushma Hazari
23 May 2024
Last updated 28 June 2024
Getting started
Getting started

How to Add an Image in Markdown Editor

Adding images to your Markdown posts is a great way to enhance your content and make it more engaging. Here’s a step-by-step guide on how to do it.

To add an image, add an exclamation mark (!), followed by alt text in brackets, and the path or URL to the image asset in parentheses. You can optionally add a title in quotation marks after the path or URL.

Basic Image Syntax

The basic syntax for adding an image in Markdown is straightforward:

1. Basic Image Embedding

![Alt Text](ImageURL)
  • Alt Text: A short description of the image.
  • ImageURL: The direct URL to the image.

Example

Here’s an example of how to add an image, and the rendered output looks like this:

Alt text

2. Adding a Title

You can also add a title to your image, which appears when you hover over it:

![Alt text](image_url "Image Title")

3. Local Images

If the image is stored locally, provide the relative path:

![Alt text](./path/to/image.jpg)

4. Image Dimensions

To specify the dimensions of the image, you can use HTML within your Markdown:

<"img src="https://example.com/image.jpg" alt="My Image" width="500" height="300">

Conclusion

Adding images to your Markdown posts is simple and effective for enhancing visual appeal and providing more context. Using the basic Markdown syntax, you can easily embed images with alt text for better accessibility. Adding titles that appear on hover is also straightforward. Although Markdown doesn’t support resizing images directly, integrating HTML allows you to adjust image dimensions to better fit your content layout. By understanding these methods, you can create more engaging and accessible posts in your Markdown editor.

Powered by Link to AI chat
  • Copyright
  • Disclaimer
  • Privacy
  • Right to information
  • Accessibility
  • Jobs in Queensland Government
  • Other languages

© The State of Queensland (Department of Education) 2025

Queensland Government