Editing wiki content
You can add images and links to content in your wiki, and use some supported MediaWiki formats.
Who can use this feature?
Wikis are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud and GitHub Enterprise Server. For more information, seeGitHub’s plans.
In this article
Adding links
You can create links in wikis using one of the following formats. For example:
- If your pages are rendered with Markdown, the link syntax is
[Link Text](full-URL-of-wiki-page)
. - With MediaWiki syntax, the link syntax is
[[Nameofwikipage|Link Text]]
.
Adding images
Wikis can display PNG, JPEG, and GIF images.
On GitHub, navigate to the main page of the repository.
Under your repository name, click Wiki.
Using the wiki sidebar, navigate to the page you want to change, and then clickEdit.
In the wiki toolbar, click.
In the "Insert Image" dialog box, type the image URL and the alt text (which is used by search engines and screen readers).
ClickOK.
Linking to images in a repository
You can link to an image in a repository on GitHub by copying the URL in your browser and using that as the path to the image. For example, embedding an image in your wiki using Markdown might look like this:
[[https://github.com/USERNAME/REPOSITORY/blob/main/img/octocat.png|alt=octocat]]
Adding mathematical expressions and diagrams
You can use Markdown to add rendered math expressions, diagrams, maps, and 3D models to your wiki. For more information on creating rendered math expressions, seeWriting mathematical expressions. For more information on creating diagrams, maps and 3D models, seeCreating diagrams.
Supported MediaWiki formats
No matter which markup language your wiki page is written in, certain MediaWiki syntax will always be available to you.
- Horizontal rules via
---
- Shorthand symbol entities (such as
δ
or€
)
For security and performance reasons, some syntaxes are unsupported.
- Transclusion
- Definition lists
- Indentation
- Table of contents