Wiki Markup Guide - Links & Files

This page provides a guide for adding an assortment of links to a wiki page.

Wiki Guides

Index

External Links

External links allow you to link to any url outside your project.
Source Markup
[url:http://www.codeplex.com]
[url:CodePlex|http://www.codeplex.com]
[url:Email Someone|mailto:someone@codeplex.com]

Rendered Markup
http://www.codeplex.com
CodePlex
Email Someone

File Links

File links allow you to link to files that you have uploaded on to a wiki page.
Source Markup
[file:_file id_]
[file:Friendly Text|_file id_]

// Note:
// Leading and trailing whitespace is considered part of the file name in the following markup
[file:_file name_]
[file:Friendly Text|_file name_]
 
// Examples:
[file:3753]
[file:Green Hexagon|3753]
[file:project_icon_lrg.gif]
[file:Green Hexagon|project_icon_lrg.gif]

Rendered Markup
3753
Green Hexagon
project_icon_lrg.gif
Green Hexagon

Image Links

Image links allow you to link to images, either uploaded to a wiki page or hosted elsewhere and linked from the wiki.
Source Markup
[image:_file id_]
[image:Alternate Text|_file id_]

// Note: 
// Leading and trailing whitespace is considered part of the file name in the following markup
[image:_file name_]
[image:Alternate Text|_file name_]

[image:http://msdn.microsoft.com/en-us/vstudio/cc304057.codeplex-thumb.png]
[image:CodePlex Thumbnail|http://msdn.microsoft.com/en-us/vstudio/cc304057.codeplex-thumb.png]

// Examples: 
[image:3753]
[image:Green Hexagon|3753]
[image:project_icon_lrg.gif]
[image:Green Hexagon|project_icon_lrg.gif]
[image:http://msdn.microsoft.com/en-us/vstudio/cc304057.codeplex-thumb.png]
[image:CodePlex Thumbnail|http://msdn.microsoft.com/en-us/vstudio/cc304057.codeplex-thumb.png]

Rendered Markup
3753
Green Hexagon
project_icon_lrg.gif
Green Hexagon



CodePlex Thumbnail

Hyperlinking Images

Images can be hyperlinked using the format below.
Source Markup
[image:<Friendly Name>|<image name or link to the image>|<URL pointed to by image>]

//For example:

[image:My Image|http://www.domain.com/myimage.jpg|http://www.domain.com]

[image:My Image|my_image.jpg|http://www.domain.com]
Rendered Markup
CodePlex

Wrapped Content

Images also allow you to wrap content around the left or right side of it.
Source Markup
<[image:http://www.domain.com/myimage.jpg] This content will flow around the image on the right hand side.
>[imagehttp://www.domain.com/myimage.jpg] This content will flow around the image on the left hand side.

Rendered Markup
 
3753 This content will flow around the image on the right hand side.
 
3753 This content will flow around the image on the left hand side.

Project Links

Project links allow you to link to other pages in your project.

Note: Release, discussion, and work item IDs are found on their detail page under "Wiki Link". For releases this will be on the top right corner instead of listed under the release's details.

Source Markup
// links to another wiki page
[Page Name]
[Friendly Name|Page Name]

// create an anchor
{anchor:anchorName}

// link to an anchor
[#anchorName] 
[Page Name#anchorName]
[Friendly Name|Page Name#anchorName]

// links to a specific thread
[discussion:_thread id_]
[discussion:Friendly Text|_thread id_]

// links to a specific release
[release:_release id_]
[release:Friendly Text|_release id_]

// links to a specific work item
[workitem:_work item id_]
[workitem:Friendly Text|_work item id_]


Rendered Markup
Wiki Formatting
Friendly Text

RenderedLinks
Wiki Formatting
Link to Anchor

Holy Cow, this is great!
Friendly Text

Syntax Highlighting Extension
Friendly Text

Last edited Aug 26, 2010 at 10:38 PM by Ethetica, version 16

Comments

uTILLIty Oct 11, 2012 at 7:22 PM 
I'd like to reference to files (always the latest version) within the repository, instead of having to upload it separately to the page which should reference it

Ultimategolf Jul 12, 2012 at 10:37 AM 
http://ultimategolflessons.com/

DanyR Jul 1, 2012 at 2:28 PM 
@Timo_Design
Maybe I'm too late, but when you read the documentation properly you will notice that the correct syntax would be {"..."} where the doublequotes are essential to 'remove' the curly braces.
http://codeplex.codeplex.com/wikipage?title=Wiki%20Formatting&referringTitle=CodePlex%20Wiki%20Markup%20Guide&ANCHOR#Escaped

Timo_Design May 25, 2012 at 9:02 AM 
How do I escape a [R], It's a token I use and I want to prevent it from showing up as a link.
{[R]} does work but shows the {}...?
(using it in the release notes)

deadlydog Feb 1, 2012 at 3:33 PM 
"There really needs to be a way to make a collection of screenshot thumbnails that link to the full image..."
Seconded! I just started adding projects to Code Plex and can't believe they don't have this ability :S

YuryK Dec 3, 2011 at 8:02 AM 
[image:http://msdn.microsoft.com/en-us/vstudio/cc304057.codeplex-thumb.png]

Engin1980 Nov 7, 2011 at 9:54 AM 
Bump for "target=_blank". Any solution?

SvenKratz Oct 27, 2011 at 12:18 AM 
Is there a way to set the image width?

Maikl Sep 2, 2011 at 2:36 PM 
How to hyperlink images with target="_blank"?

amecam Oct 31, 2010 at 9:46 AM 
thanks, very useful.

jbosch Apr 30, 2010 at 7:14 AM 
what about iframes?

emacinnes Mar 28, 2010 at 6:17 PM 
Really needs a way to be able to embed YouTube videos, my app training is all done in that, as is some showcase materials. Any way to do this?

How about a [youtube:LZFtKPcLff8] to automatically embed the specific movie?

nobamanothanks Sep 23, 2009 at 12:22 AM 
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||


Image markup works ONLY in profile preview... but does not display pixels in profile!

one merely sees [image:URL]


|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||

heaths Apr 19, 2009 at 8:50 PM 
How am I supposed to insert square brackets into the text themselves? I was using &#91; and &#93; before and now it's not working.

coryking Mar 16, 2009 at 12:11 AM 
Needs more formating... like way to left/right align images and blocks of text.

eugals Feb 2, 2009 at 3:09 PM 
Is there any way to configure the image presentation layout? What if I want it to be shown on the right side of the page? Please see how the image is shown at http://en.wikipedia.org/wiki/Codeplex for instance

Dykam Jan 11, 2009 at 12:30 PM 
[user:userName] would be nice.

JohanDanforth Oct 6, 2008 at 10:06 AM 
I support the request to be able to make an image link to a page/url. Perhaps it's already possible? How then?

smaillet Jul 27, 2008 at 12:04 AM 
how about adding a [changeset:xxxxx] link so that we can create links to a specific changeset?

joicekafer Jun 9, 2008 at 6:25 PM 
I also can't add an image link! :-\ I would like to add a button to incentivate people to vote on our projects to the SourceForge Community Award (http://sourceforge.net/community/cca08).

gsscoder May 9, 2008 at 12:19 AM 
If I create a new page from an XYZ Release. How to make this page child of this release and not child to Home?

Merrion May 6, 2008 at 9:08 PM 
Any way of doing in-line silverlight video streaming?

dotnetCarpenter Jan 13, 2008 at 11:02 PM 
Does anyone know the link name for reporting bugs?

identy Jan 13, 2008 at 12:34 PM 
image resize ¿?

comun Dec 23, 2007 at 11:49 AM 
How to add a new wiki to project?(Not home page)

Jaykul Jul 6, 2007 at 1:34 PM 
Yeah, why isn't there a way to make an image the "text" of a link?
How about links to images (which don't cause the "Save as" dialog)?
There really needs to be a way to make a collection of screenshot thumbnails that link to the full image...

Drakar Apr 30, 2007 at 4:08 PM 
No way to link an image to a website? Like [image:foo.gif [url:foo.com]]?

JamesFinnigan Mar 23, 2007 at 12:05 AM 
Shame that their isn't a [release:default] option..

donsmith Jan 12, 2007 at 11:29 PM 
I would recommend adding a link to this guide from the Quick Wiki Markup Guide. Sure would make it easy to find. I think there is already a bug/feature request for this.

I'm not on the CodePlex team, but I'll still take a stab at responding to the previous 2 comments. bheinz, I'm pretty sure _file id_ is actually a file token (a string). For example, WhatsNewOnTheProject.

vermorel, I think you intended your second colon to be a pipe character [url:My Website|http://www.example.com]. I guess you can't edit these comments after you leave them, huh?

vermorel Jan 11, 2007 at 7:52 AM 
I would suggest to add the syntax [url:My Website:http://www.example.com] to the "Quick Wiki Markup Guide". It's quite handful.

Best regards, Joannès
http://www.lokad.com, time-series forecasts provider

bheinz Dec 20, 2006 at 8:25 AM 
The {file:Friendly Name|_file id_]} didn't seem to work for me [file:my file|4827]