# Create a Simple Markdown-Powered Wiki with Torchpad

by

Wikis are great ways to collaborate on information, whether it’s for your internal documentation or a public website or directory like Wikipedia. The only problem is that wikis are often complicated to create and use, as was easily apparent in our tutorial on building your own wiki. They use an unusual markup language inside an often dated UI. It’s far from surprising that it’s hard to get people to contribute to wikis.

So many content management systems today work with Markdown, the simple text markup language that’s easily converted to HTML. It’s a far simpler way to write formatted text. Torchpad took the simplicity of Markdown and combined it with the power of a wiki to make a far simpler wiki engine.

In this tutorial, you’ll learn everything you need to make your own Markdown-powered wiki in Torchpad and get your team collaborating with a wiki that’s simple to use.

## Create Pages

Add a new page to your wiki by clicking the New Page button in the top left of the screen. In the sheet that appears, type the name of your new page in the Page name field. For now, leave the Dir path field blank, and click Create.

The new page you just created will be blank, save for the title you gave it. Click the Edit button in the top right to get started adding some content to it, and you’ll see the edit view for that page.

In the edit view, you can use any normal Markdown syntax, along with the additions from GitHub-Flavoured Markdown. The buttons along the top can be used to quickly insert the necessary symbols for things like headers, lists and emphasis.

There are a few keyboard shortcuts you can use, which are displayed in the buttons they correspond to. Save your changes with Command-S, and exit the edit view with Command-B. Press Command-D to preview what the page will look like in its current state, which is useful for checking if the Markdown will be interpreted in the way you intended. If you’re not in the edit view, press Command-E to enter it.

## Create Pages in Folders

You can also add pages inside folders, if you want to group pages together or give pages URLs with multiple parts. To do this, when you click New Page, add the path you want for the page in the Dir path field. For example, if you want the Cheese page to be located at /Food/Dairy/Cheese, type “Cheese” in the Page name field, and “Food/Dairy” in the Dir path field.

Click Create to create the new page, and you’ll see the new page listed in the folder structure you specified.

When editing a page on Torchpad, there are a couple of extra things you can do that aren’t in standard Markdown. Most importantly, there’s a special syntax for creating an internal link (a link to another page on the same wiki).

To link to another page, surround the name of the page in two sets of square brackets like this: [[Page Name]]. This will automatically create the link for you, instead of having to find the whole URL to put into a Markdown link.

If you’d like to link to a page, but display different text as the link, you can do that too. Just put the text you’d like to display first, followed by a pipe character and then the name of the page, like this: [[Text to display | Page Name]].

When you visit the page, you’ll see the link displays the text before the pipe, but links to the page named after the pipe.

Images can be added to any page just like with regular Markdown, but Torchpad will also host the images for you if they’re not already online with a URL to specify. Drag and drop the image onto the page, and it’ll be uploaded to Torchpad.

Once it’s uploaded, the Markdown for displaying the image will be inserted automatically. The alt text will be set to the filename of the image you dragged in.

## Add Code and Math to Pages

To add a code listing to a page, simply type three backticks on the lines immediately before and after the code.

On the live page, the code will be changed to an appropriate font, and syntax highlighting will be applied to make it easier to read.

To change the syntax highlighting to match the language the code is written in, type the name of the language directly after the first set of back ticks, such as ruby. This will ensure the code is highlighted properly, picking up the keywords from that language.

As well as code, you can add mathematical formulae to your pages using MathJax. Torchpad treats MathJax as a code language, so surround your MathJax code with triple backticks, and specify the language as mathjax.

The MathJax code will be rendered on the live wiki page as you’d expect.

You can also put MathJax inline, same as code can be inline in a sentence. To do this, surround the code with dollar signs, and surround that with single backticks.

Same as before, the MathJax will be rendered on the live page, but styled to fit inline.

## Publish Edited Pages

Once you’ve finished editing a page, you’ll want to show it to the world. To publish a page, finish editing and exit the edit view. Click on Draft next to the Edit button, and choose eitherPublish or Set Private.

Choosing Publish makes the page accessible by anyone without being logged into Torchpad. Choose Set Private to make the page only accessible to people who are authors on your wiki. If someone who isn’t part of your wiki tries to access a private page, they’ll see a “not found” message, as if the page didn’t exist at all.

## Wiki Settings

There are a few settings you can change for a Torchpad wiki. Click Settings on the left, above the page list, to access them.

The Subdomain option lets you change the URL for your wiki. You can choose anything you want here, and your wiki’s URL will become http://what-you-chose.torchpad.com`.

The Wiki name option changes the name of the entire wiki. The name you choose is displayed in the title bar of your wiki, and doesn’t have to match the subdomain you pick.

Check the Private Wiki checkbox to make the entire wiki private. This means that only members of your wiki can view it.

Finally, grab your Google Analytics ID from the Analytics site, and paste it into the Google Analytics ID field. This will log any visits to your wiki to Google Analytics to allow you to monitor traffic to it.

The important part of a wiki is collaboration, which means you need to add some more people. To get started, click Settings, and then navigate to the Members page.

Add a new member by typing their email address into the Email field. Then, choose a Role. An owner has full administrative privileges, meaning they can change anything you can, including changing settings. An author can edit pages, but can’t change settings for the wiki as a whole. A watcher is simply someone who can access private pages of the wiki.

Once added, a member can be removed by clicking Remove next to their name in the members list.