diff --git a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md index 1a460ac113d9..60d93eeb1dea 100644 --- a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md @@ -163,6 +163,23 @@ For example, the following code displays a sun image for light themes and a moon The old method of specifying images based on the theme, by using a fragment appended to the URL (`#gh-dark-mode-only` or `#gh-light-mode-only`), is deprecated and will be removed in favor of the new method described above. {% endif %} +### Animated images with Graphic Interchange Format (or GIFs) + +You can display an animated image by using the HTML `` element or in combination with the `` for using with themes. These animated images supports embedding GIFs into your issues, pull requests, discussions, comments and `.md` files. + +For example, the following code displays an animated octo-cat with `` element: + +```HTML +This is GIF +``` + +This is GIF + + +{% tip %} + +**Tip:** When you want to display a GIF which is in GitHub, you should use GitHub raw URL links instead of GitHub content URL links. + ## Lists You can make an unordered list by preceding one or more lines of text with - or *.