links: [[card name]] or [[card name|clickable text]] nesting: {{card name}} or {{card name|view}}

or even simpler:

To link, type a card name in double brackets: [[Portland, OR]] More Documentation

I don't like the suggested text changes, but I do like the link to editing help. Should go to wagn.org (this is fairly standard practice for markups). John, if you create a markup documentation card, we can link to that one and knock it out. Then we can replace this ticket with a separate one for fixing the timing bug that sometimes keeps the editing suggestions from showing up.

  --Ethan McCutchen.....Tue Sep 16 14:27:26 -0700 2008

the reason I don't like the text changes is that they're too lengthy and will bust narrow editors. I think we should treat the help text as a reference for frequent users, not as a narrative instruction for new users.

Eventually we'll be able to pull in the full markup help card right from wagn.org...

  --Ethan McCutchen.....Tue Sep 16 14:30:22 -0700 2008

Shorter draft in +solution now.