Markdown: Links to markdown files in nested directories

markdown bitbucket wiki
gaussblurinc picture gaussblurinc · Jan 15, 2014 · Viewed 9.6k times · Source

I created a Bitbucket wiki.

And I find an issue: how to make links to pages in nested folders?

I have a structure:

  • one.md
  • two.md
  • dir1/
    • three.md
  • dir2/
    • four.md

If I want to add on home wiki pages one or two, I will use

[[one]]  
[[two]]

But if I write something similar for other pages...

[[dir1/three]]  
[[dir2/four]]

nothing seems to be ok.

What is the correct symbol that separate folders in path to file?

What is the correct way for nested directories in markdown wiki?

Answer

Chris picture Chris · Jan 15, 2014

Bitbucket doesn't recognize links of this type using the [[ ... ]] syntax. However, the full link syntax [link text](path/to/target) seems to work fine:

[three](dir1/three)
[four](dir2/four)

Related questions

How to write one new line in Bitbucket markdown?

Is it possible to write a new line (NOT a paragraph) in the Bitbucket markdown? Two new lines in the source creates one new paragraph. I only want a new line. And I don't want to use a code block.

Read More
How to markdown nested list items in Bitbucket?

I'm trying to see my markdown nested list items rendered with corresponding indentation when viewed in a browser live from the Bitbucket pages. But I can't figure out how it works even when using their examples (updated): * Item 1 * Item 2 * Item 3 * …

Read More
Add images to README.md on BitBucket

Can I somehow reference the image from readme.md file so that it renders when viewed in BitBucket directly from project (without hosting the image elsewhere on web) ? UPDATE: The issue was resolved so it's working now as it was …

Read More