1. Bitbucket Website
  2. Public Issue Tracker
  3. master


Issue #3491 open

Add live-preview when editing Markdown files online (BB-3466)

André Thieme
created an issue

In the Overview tab my README.md can be displayed. Unfortunately I have no preview of this, so this might take me several commits to get it right. It would be great if you offered a preview, so that I can write my readme directly in the browser, or at least paste it there to see it. For the issue tracker you already provide such a preview (albeit it is not previewing Markdown, but another format).

Comments (41)

  1. Anonymous

    +1 Hello, dear dev team! :] I know and understand, that you're treating BitBucket like an orphan child (because it is free for most users) and you're focusing all your powers on JIRA. But... did you noticed, that within two days we will celebrate second birthday since this issue was risen? Yes, two years has passed and you did nothing to a feature request, that most of us takes as crucial and fundamental. No matter, if you like this or not, we really need a live preview for all the Markdown edits!

  2. Hữu Ðà Trần

    Using external tools may solve basic Markdown display, but when using specific feature like syntax highlighting, it's another story.

    And of course, using this becomes worse when you take documents from Github and bring it here, it just doesn't work (```lang vs :::lang).

  3. Zachary Davis [Atlassian] staff

    Hi all, we currently offer preview functionality for markdown on all comments, pull request and issue descriptions, and wikis.

    Just to clarify, what is being asked for here is specifically a preview for the README (or, presumably, other markdown files) when editing source online with Bitbucket?

  4. André Thieme reporter

    Yes exactly Zach, when I want to edit a .rst or .md file online, I would love to see a preview before I saw my changes. Because otherwise I will end up with 8 unnecessary commits, cause my readme/docs don’t get displayed as I hoped for. It seems trivial to add this feature, as BitBucket already is able to render such files, and there already are certain preview capabilities implemented. Would be very nice if you could add this.

  5. Stephen Sykes

    Even worse, what works fine in hashify or dillinger fails in the bitbucket README.md file. So I have a README which is poorly formatted, because your formatting is not consistent with standard online tools, and you have no preview of your own.

  6. Fidel Tamondong

    ..or if we can't have a preview feature, it'd be nice if Bitbucket renders *.md files exactly like Hashify, for example, so we could at least see what we're doing there instead.

  7. Merlin Patterson

    +1 especially since Bitbucket has different parsing rules then some of the mentioned preview pages.

    For instance, I did not know Bitbucket required 4 spaces of indentation for sublists.

    Also, while a live preview would be preferred, a confirmation page with the preview on it would work too.

  8. Log in to comment