You can use Markdown tables to organize information. To check the image has rendered correctly, click the Preview tab.įor more information on using images in Markdown, see ' Basic writing and formatting syntax.' Example of a responsive image How the image looks To make the image accessible for visitors who are using a screen reader, replace YOUR-ALT-TEXT with a description of the image. Replace YOUR-DEFAULT-IMAGE with the URL of an image to display in case neither of the other images can be matched, for example if the visitor is using a browser that does not support the prefers-color-scheme feature.Replace YOUR-LIGHTMODE-IMAGE with the URL of an image to display for visitors using light mode.Replace YOUR-DARKMODE-IMAGE with the URL of an image to display for visitors using dark mode.Alternatively, to try the feature first, you can copy the URLs from our example below. Replace the placeholders in the markup with the URLs of your chosen images. For more information, see ' Managing your theme settings.'Ĭopy and paste the following markup into your README.md file. Here, you'll add a responsive image, such as a banner, to the top of your profile README.īy using the HTML element with the prefers-color-scheme media feature, you can add an image that changes depending on whether a visitor is using light or dark mode. You can include images in your communication on GitHub. In the upper-right corner of any GitHub page, click your profile photo, then click Your profile. If you already have a profile README, you can edit it from your profile page. Edit the README.md file and delete the template text (beginning # Hi there) that is automatically added when you create the file.For more information, see ' Managing your profile README.' Create a repository with the same name as your GitHub username, initializing the repository with a README.md file.

If you don't already have a profile README, you can add one.

The README is displayed at the top of your profile page. Your profile README lets you share information about yourself with the community on. For more information, see ' Creating gists.' Creating or editing your profile README If you already have a profile README, you can follow this guide by adding some features to your existing README, or by creating a gist with a Markdown file called something like about-me.md. If you're new to Markdown, you might want to start with ' Basic writing and formatting syntax' or the Communicate using Markdown GitHub Skills course. In this guide, you'll learn some advanced formatting features by creating or editing a README for your GitHub profile. You can use Markdown syntax, along with some additional HTML tags, to format your writing on GitHub, in places like repository READMEs and comments on pull requests and issues. Markdown is an easy-to-read, easy-to-write language for formatting plain text.

Macdown syntax