Get started with Bitbucket Cloud
New to Bitbucket Cloud? Check out our get started guides for new users.
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.
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.
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.
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 | Markdown
We support the following extensions for Python-Markdown: codehilite, 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. |
Create a wiki
The repository administrator can choose whether a repository includes a wiki or not. Learn how to enable a wiki.
Clone a wiki
Make a copy of a wiki page.
Special support for Creole
A wiki's support for the Creole syntax is compatible with the Creole 1.0 specification.
Macro reference for Creole markup
Learn which macros are compatible with Creole markup in a wiki.
Make a wiki private or public
Make a wiki publicly available, or restrict access to it by making it private.
Use syntax highlighting in a wiki
Use the Pygments library to highlight snippets of text in a wiki page.
Add images to a wiki page
Learn the syntax to add images to a wiki page.
Add a table of contents to a wiki
Learn the syntax to add a table of contents to a wiki page.
Was this helpful?