How to structure GitHub wiki files?

Question

I have cloned one of my GitHub project's wiki locally, and I want to restructure the file system. By default different pages added to the wiki are all created in the parent directory:

/wiki
     home.md
     wiki_page_1.md
     ...

I want have a directory structure similar to this:

/wiki
  /setup
    setup_procedures.md
    index.md
  /development
    index.md
    tools.md
  /images
    front_page.png

I've tried to structure my wiki files similarly, but it's not working for the .md files. However, it works for the images folder. Is there a way to make this work?

Answer 1

If GitHub is still using github/gollum, then, as explained in "How can you use subdirectories in a GitHub wiki checkout?", subfolders are not supported (or were buggy at the time of the fork).

More recent versions of gollum/gollum supports that organization, even though recent PR (Pull Requests) are still fixing issues around it (like PR 787).

The OP tsega adds in the comments:

tried to look into the Gollum wiki myself and it turns out you can organize your files under directories but that will not be how you access them.

Every page is accessed from the root of the wiki,e.g. github.com/user/repo/wiki/file-name not github.com/user/repo/wiki/directory/file-name.

The file names should be unique, and if you want to have proper titles they need to be capitalized and dashed (not underscored).

Answer 2

I've just hit the same problem and I've solved it (kinda) using a custom menu bar, and using regular Markdown, i.e. headers and links to create a folder structure.

Answer 3

In 2022 this is still not possible.
Please upvote this feature request 👈