create new tag
, view all tags
ALERT! NOTE: This is a DistributionDocument. Please help maintain high quality documentation: This is a wiki, please fix the documentation if you find errors or incomplete content. Put questions and suggestions concerning the documentation of this topic in the comments section below. Use the Support web for problems you are having using TWiki.

TWiki Shorthand Basics

If you can enter text, you're ready for TWiki. With a few simple, intuitive TextFormattingRules, you'll be able to use plain text to create well-styled postings, instantly. Here's a fast-track guide to shorthand basics...

  • Separate each paragraph with a blank line.
  • To display a word or phrase in bold type, put it in asterisks: *bold type*.
  • To display a word or phrase in italic, put it in underscores: _italic_.
  • To display a word or phrase in bold italic, put it in double underscores: __bold italic__.
  • To link to another Wiki topic, type the WikiWord for that topic. To link to a Wiki topic in another web, type the name of the web, and a dot, first: Sandbox.WebHome.
  • If you enter a WikiWord for a topic that doesn't exist, it'll appear highlighted with a red-link, prompting you (or someone else) to start off the new topic by clicking the link - NewTopic (click the link, but don't save, to preserve the example!).
  • When entering WikiName signatures - like, guest - include "Main." as a prefix, since all TWiki member pages are in the Main web: Main.YourName.
  • For an external link, type the full URL: http://twiki.org/.
  • To prevent a WikiWord from becoming a link, type <nop> or an exclamation point first: <nop>NoLinkPlease or !NoLinkPlease.
  • To indent with a bullet, enter [space][space][space][asterisk][space].
    • Use multiples of 3 spaces to start nested bullets.
      • That's 3-6-9-...
  • To create a numbered list:
    1. Start items in a numbered list with [space][space][space][1][space].
    2. The "1" (or any number) will be replaced by the correct number, in order.
    3. To add a new paragraph without restarting list numbering, use the %BR% variable, like below:
      Text added (in new paragraph)
    4. and list numbering continues.
  • Always start counting spaces for bullets and such from the beginning of a new line.
  • To include an image, type its URL. You also can Attach an image to the page and display it with text
  • To display a word or phrase in MONOSPACED TYPE, put it in equal signs: =like this=.
    Use ==two== for bold: bold mono.
  • Use <verbatim> to enclose code excerpts, filenames, and other unformatted text:
    unformatted text!

    ALERT! NOTE: VARIABLES can be set within verbatim tags, that is, they are not disabled
  • Use <literal> to enclose anything that TWiki must not touch under any circumstances, such as in-line HTML code.
  • Follow GoodStyle recommendations when editing topics.
  • See TextFormattingRules for the complete set of formatting rules.

Related topics: WikiSyntaxSummary, WikiWord, WikiNotation, TextFormattingRules, TWikiEditingShorthand, TWikiRenderingShortcut, TWikiShorthand

Comments & Questions about this Distribution Document Topic

Is there any functional difference between verbatim and pre at this point in time? If so, maybe we should mention verbatim as an alternative. (I switched from pre to verbatim but don't recall exactly why, but it seemed to solve a problem I was having at the time.) PS: I'll delete this note and the response when I see it.

-- RandyKramer - 02 Dec 2001

I removed verbatim from the example 'cause I was...sleepy. I removed it, actually, because of that, and also because this is a quick start page - people may not even know HTML, pre PLUS verbatim is probably confusing here, people needing verbatim would look in TWikiShorthand or TextFormattingRules... WDYT? (Also, as the titles get shuffled around, and rewrites slowly happen, the point approaches where are the User's Guide stuff will get edited down and some pages combined, since there's a fair bit of redundancy here right now. Again, WDYT?) That's the reason (and rough plan)... Comments?

(Thanks for the copy editing here and there!!) You're welcome! -- rhk

-- MikeMannix - 02 Dec 2001

"verbatim" displays the intervening text as-is. With "pre", HTML tags are interpreted. The example above takes advantage of this difference to make things bold.

-- JonReid - 04 Dec 2001

If we don't want to list both "pre" and "verbatim" (which is fine), I think the change from "pre" to "verbatim" is the best approach (as it is now). With that said, I have no problem with any or all of my comments being deleted from this page.

-- RandyKramer - 05 Dec 2001

Honestly, I think if one is mentioned, the other one should be too. It's a significant distinction, and could be frustrating for someone who's expecting one thing, and gets something else. On the other hand, if only one is to be mentioned, I think "verbatim" is better since it lets people write example HTML code.

-- NickVargish - 08 May 2002

I think they should both be mentioned - the PRE could perhaps be left for an 'advanced features' page if there is too much for the basic syntax page.

-- RichardDonkin - 09 May 2002

Wow, I'm used as part of the example. Interesting, and a bit spooky.

-- JonathanCline - 15 Jul 2002

Added: how to insert paragraph into numbered list without breaking numbering.

-- PeterMasiar - 03 Jan 2003

Seems like the this topic (WikiSyntax) and the TextFormattingFAQ topic are somewhat overlapping. There really should be a single approach to explaining the basics of editing topics. If there's still a need for 2 topics, they should reference each other and avoid overlap of steps to perform specific actions.

-- DavidMulter - 17 Dec 2004

WikiWord linking can also be prevented by prepending an exclamation point.

-- JohnMcLeod - 2005-03-03

Please use the Support forum if you have questions about TWiki features. This comment section is about the documentation of this topic.
Edit | Attach | Watch | Print version | History: r32 < r31 < r30 < r29 < r28 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r32 - 2010-06-13 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2015 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.