1
0
mirror of synced 2026-01-06 06:02:35 -05:00
Files
docs/content/github/building-a-strong-community/editing-wiki-content.md
2020-11-02 15:12:44 -06:00

57 lines
2.3 KiB
Markdown

---
title: Editing wiki content
intro: 'You can add images and links to content in your wiki, and use some supported MediaWiki formats.'
redirect_from:
- /articles/adding-links-to-wikis/
- /articles/how-do-i-add-links-to-my-wiki/
- /articles/how-do-i-add-or-upload-images-to-the-wiki/
- /articles/needs-writing-review-how-do-i-add-or-upload-images-to-the-wiki/
- /articles/how-do-i-add-images-to-my-wiki/
- /articles/adding-images-to-wikis/
- /articles/supported-mediawiki-formats/
- /articles/editing-wiki-content
product: '{% data reusables.gated-features.wikis %}'
versions:
free-pro-team: '*'
enterprise-server: '*'
github-ae: '*'
---
### Adding links
You can create links in wikis using the standard markup supported by your page, or using MediaWiki syntax. 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 `[[Link Text|nameofwikipage]]`.
### Adding images
Wikis can display PNG, JPEG, and GIF images.
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-wiki %}
3. Using the wiki sidebar, navigate to the page you want to change, and then click **Edit**.
4. On the wiki toolbar, click **Image**.
![Wiki Add image button](/assets/images/help/wiki/wiki_add_image.png)
5. In the "Insert Image" dialog box, type the image URL and the alt text (which is used by search engines and screen readers).
6. Click **OK**.
#### Linking to images in a repository
You can link to an image in a repository on {% data variables.product.product_name %} 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]]
### Supported MediaWiki formats
No matter which markup language your wiki page is written in, certain MediaWiki syntax will always be available to you.
- Links ([except Asciidoc](https://github.com/gollum/gollum/commit/d1cf698b456cd6a35a54c6a8e7b41d3068acec3b))
- Horizontal rules via `---`
- Shorthand symbol entities (such as `δ` or `€`)
For security and performance reasons, some syntaxes are unsupported.
- [Transclusion](https://www.mediawiki.org/wiki/Transclusion)
- Definition lists
- Indentation
- Table of contents