29 lines
2.3 KiB
Markdown
29 lines
2.3 KiB
Markdown
---
|
|
title: About wikis
|
|
intro: 'You can host documentation for your repository in a wiki, so that others can use and contribute to your project.'
|
|
redirect_from:
|
|
- /articles/about-github-wikis/
|
|
- /articles/about-wikis
|
|
product: '{% data reusables.gated-features.wikis %}'
|
|
versions:
|
|
free-pro-team: '*'
|
|
enterprise-server: '*'
|
|
github-ae: '*'
|
|
---
|
|
|
|
Every {% data variables.product.product_name %} repository comes equipped with a section for hosting documentation, called a wiki. You can use your repository's wiki to share long-form content about your project, such as how to use it, how you designed it, or its core principles. A README file quickly tells what your project can do, while you can use a wiki to provide additional documentation. For more information, see "[About READMEs](/articles/about-readmes)."
|
|
|
|
With wikis, you can write content just like everywhere else on {% data variables.product.product_name %}. For more information, see "[Getting started with writing and formatting on {% data variables.product.prodname_dotcom %}](/articles/getting-started-with-writing-and-formatting-on-github)." We use [our open-source Markup library](https://github.com/github/markup) to convert different formats into HTML, so you can choose to write in Markdown or any other supported format.
|
|
|
|
Wikis are available to the public in public repositories, and limited to people with access to the repository in private repositories. For more information, see "[Setting repository visibility](/articles/setting-repository-visibility)."
|
|
|
|
You can edit wikis directly on {% data variables.product.product_name %}, or you can edit wiki files locally. By default, only people with write access to your repository can make changes to wikis, although you can allow everyone on {% data variables.product.product_name %} to contribute to a wiki in a public repository. For more information, see "[Changing access permissions for wikis](/articles/changing-access-permissions-for-wikis)".
|
|
|
|
### Further reading
|
|
|
|
- "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)"
|
|
- "[Creating a footer or sidebar for your wiki](/articles/creating-a-footer-or-sidebar-for-your-wiki)"
|
|
- "[Editing wiki content](/articles/editing-wiki-content)"
|
|
- "[Viewing a wiki's history of changes](/articles/viewing-a-wiki-s-history-of-changes)"
|
|
- "[Searching wikis](/articles/searching-wikis)"
|