Use wikis to store documents

Wikis are not available in all Bitbucket workspaces

Wikis are not supported in workspaces administered through admin.atlassian.com. Any wiki features will be disabled if you create or following a transfer to a workspace administered through admin.atlassian.com. Similar to the Deployment variables, if you have already transferred the repository, you can transfer it back to the original workspace to regain access to the wiki and issues. Wikis can be exported via cloning since they are stored as a separate repository.

When you add a repository to Bitbucket Cloud, you also get a wiki. The wiki is a simple place to keep documents. Some people use it as their project home page. The wiki is a Git repository, so you can clone it and edit it like any other source files.


Want to Improve or Comment on our Wiki Feature?

Our development team reviews issues in our issue tracker to help prioritize new production features. If you want to request functionality or otherwise comment on the Wiki feature, your voice is best heard by filing an issue on the issue tracker. You can view a list of open Wiki issues here or here.


Supported Markup Languages

Bitbucket Cloud wikis support Creole, Markdown, reStructuredText, and Textile syntax. There is special Bitbucket markup that you can use to link to Bitbucket objects from wikis.

In some cases, you can use a Bitbucket macro or the Bitbucket markup to do the same thing. The Bitbucket markup works in all languages; The Bitbucket macros work only with Creole markup.

Supported File Extensions

With the exception of Creole markup, Bitbucket supports the same markup in README files as it does in wiki files. This table lists the supported filename extensions and their corresponding mark up languages:

Extension

Language

.md
.mkd
.mkdn
.mdown
.markdown 
.text 

Markdown

We support the following extensions for Python-Markdowncodehilite, tables, def_list, del, footnotes, headerid, sane_lists, abbr, fenced_code, toc, wikilinks.

We don't support arbitrary HTML in Markdown, for example <table> tags.

.rst

reStructuredText (reST)

.textile

Textile

.wiki

Creole

For Bitbucket wikis only, not supported with README files.

Still need help?

The Atlassian Community is here for you.