Adding or editing wiki pages

You can add and edit wiki pages directly on GitHub or locally using the command line.

Los Wikis se encuentran disponibles en repositorios públicos y privados con GitHub Free y GitHub Free para organizaciones, y en repositorios privados y públicos con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y Servidor de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

Adding wiki pages

  1. En GitHub, visita la página principal del repositorio.
  2. Debajo de tu nombre de repositorio, da clic en Wiki. Enlace de menú del Wiki
  3. In the upper-right corner of the page, click New Page. Wiki new page button
  4. Optionally, to write in a format other than Markdown, use the Edit mode drop-down menu, and click a different format. Wiki markup selection
  5. Use the text editor to add your page's content. Wiki WYSIWYG
  6. Type a commit message describing the new file you’re adding. Wiki commit message
  7. To commit your changes to the wiki, click Save Page.

Editing wiki pages

  1. En GitHub, visita la página principal del repositorio.
  2. Debajo de tu nombre de repositorio, da clic en Wiki. Enlace de menú del Wiki
  3. Using the wiki sidebar, navigate to the page you want to change. In the upper-right corner of the page, click Edit. Wiki edit page button
  4. Use the text editor edit the page's content. Wiki WYSIWYG
  5. Type a commit message describing your changes. Wiki commit message
  6. To commit your changes to the wiki, click Save Page.

Adding or editing wiki pages locally

Wikis are part of Git repositories, so you can make changes locally and push them to your repository using a Git workflow.

Cloning wikis to your computer

Every wiki provides an easy way to clone its contents down to your computer. You can clone the repository to your computer with the provided URL:

$ git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.wiki.git
# Clones the wiki locally

Once you have cloned the wiki, you can add new files, edit existing ones, and commit your changes. You and your collaborators can create branches when working on wikis, but only changes pushed to the default branch will be made live and available to your readers.

About wiki filenames

The filename determines the title of your wiki page, and the file extension determines how your wiki content is rendered.

Wikis use our open-source Markup library to convert the markup, and it determines which converter to use by a file's extension. For example, if you name a file foo.md or foo.markdown, wiki will use the Markdown converter, while a file named foo.textile will use the Textile converter.

Don't use the following characters in your wiki page's titles: \ / : * ? " < > |. Users on certain operating systems won't be able to work with filenames containing these characters. Be sure to write your content using a markup language that matches the extension, or your content won't render properly.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.