Note: As of Docs 2.6.0, you can upload images directly to your Docs pages. This feature requires a premium plan.
Uploading Directly (Premium)
If you have a premium plan, you can upload images without any Markdown - just paste your image directly into the editor where you want it to appear. Example video
Using an external hosting provider
Warning: If your hosting provider goes down, all of your images will be unavailable. We recommend using our built-in upload service for just $5/mo or Encoded (Learn about our relation with Encoded here)
You can embed images using standard Markdown syntax:

Example:

The alt text (e.g. Alt text) improves accessibility and is displayed if the image fails to load. If you prefer to use an external image host instead of uploading directly, simply paste your image URL in place of image-url.
You CANNOT use videos with Docs unless you are using our built-in uploader.