¶ Adding Pages & Links
Your wiki offers several ways to add pages and links. It's best to think of these ideas together so that you always give users a way to navigate to a page before you create it. That way, you don't create content that's unreachable to your users.
Good organization of your folder and page names makes it easier to add links later.
¶ Creating Pages
When you click a link to a page that doesn't exist, you'll have a chance to create it (if you have edit permission).
- You can start from an empty page, or use an existing page as a template.
- We recommend markdown for editing new pages.
- You can also choose a WYSIWYG (word processor) or raw HTML editor.
- You cannot change the editor after the page is created.
¶ Linking to an Existing Page
- Choose the page to link to by navigating the
foldersandpagessections of the dialog. - Then click SELECT.
Links get added with the [page-name] in brackets and the (link-address) in parentheses.
- Change the
page-nameto link text that makes sense in the sentence.
¶ Auto-Completing Links
- You can write any part of the
[page-name]in brackets followed by(to auto-complete the(page-address).
¶ Example 1
Changing the link text of an inserted link.
You can use [formatting](/content/formatting) to make pages easier to read.
You can use [Special Formatting](/content/formatting) to make pages easier to read.
¶ Example 2
Using auto-complete for links.
Use [markdown](
Use [markdown](/content/formatting)
¶ Linking to a New Page
- Type the new folder location and page name in the box.
If you later change the name or folder location of page, you must manually update any corresponding navigation or links.
- If you refer to an existing folder, the page will go in it.
- If you invent a new folder, it will be created.
We recommend using all lowercase folder and page names. Use the shortest name that helps you find the page. Instead of spaces, use a
-character.
- Links get added with the
[page-name]in brackets and the(link-address)in parentheses. - Change the
page-nameto link text that makes sense on the page. - When you click the link from the page, you'll have the opportunity to create the new page.
¶ Example
[outline](/organization/outline)
[Outlining Navigation](/organization/outline)
¶ Linking Outside the Wiki
Links from a wiki page to an outside document or website must be written in markdown.
- Write the
[link-text]in brackets and the(link-address)in parentheses.
¶ Example
Visit the Internet Archive.
Download the new video today.
Visit the [Internet Archive](http://archive.org).
Download the [new video](C:\Users\David\Videos\New-Video.mp4) today.
¶ Link Lists
- Use link lists on landing or section pages to help users find deeper content.
- Add an optional
*description*in stars after the link text. - End the list with
{.links-list}
¶ Example 1
Create a simple link list.
- [Romeo and Juliet](http://www.gutenberg.org/cache/epub/1112/pg1112.txt)
- [The Merchant of Venice](http://www.gutenberg.org/cache/epub/1114/pg1114.txt)
- [King Lear](http://www.gutenberg.org/cache/epub/1128/pg1128.txt)
{.links-list}
¶ Example 2
Add a description to a link list item.
- [The Taming of the Shrew *This Shakespeare play was the basis of the movie *10 Things I Hate About You.**](http://www.gutenberg.org/cache/epub/1107/pg1107.txt)
{.links-list}
¶ Quick Links
- Consider using a list of Quick Links to help users navigate from within a deeper topic.
- Start the list with
> - Separate each link with
|. - End the list with
{.is-info}.
¶ Example
> [Special Formatting](/content/formatting) | [Outlining](/organization/outline) | [Pages & Links](/content/pages-links)
{.is-info}