# TXT2TAGS SAMPLE

Aurelio Jargas
10/20/2010

## Introduction

Welcome to the txt2tags sample file.

Here you have examples and a brief explanation of all marks.

The first 3 lines of the this file are used as headers, on the following format:

    line1: document title
    line2: author name, email
    line3: date, version

Lines with balanced equal signs = around are titles.

## Fonts and Beautifiers

We have two sets of fonts:

The NORMAL type that can be improved with beautifiers.

The TYPEWRITER type that uses monospaced font for pre-formatted text.

We will now enter on a subtitle...

### Beautifiers

The text marks for beautifiers are simple, just as you type on a plain text email message.

We use double *, /, - and _ to represent bold, italic, strike and underline.

The bold italic style is also supported as a combination.

### Pre-Formatted Text

We can put a code sample or other pre-formatted text:

      here    is     pre-formatted
    //marks// are  **not**  ``interpreted``

And also, it's easy to put a one line pre-formatted text:

    prompt$ ls /etc

Or use `pre-formatted` inside sentences.

### More Cosmetics

Special entities like email (duh@somewhere.com) and URL (http://www.duh.com) are detected automagically, as long as the horizontal line:

^ thin or large v

You can also specify an explicit link with label.

And remember,

> A TAB in front of the line does a quotation.

> > More TABs, more depth (if allowed).

Nice.

## Lists

A list of items is natural, just putting a dash or a plus at the beginning of the line.

### Plain List

The dash is the default list identifier. For sublists, just add spaces at the beginning of the line. More spaces, more sublists.

- earth

  - america

    - south america

      - brazil

        - how deep can i go?

  - europe

    - lots of countries

- mars

  - who knows?

The list ends with two consecutive blank lines.

### Numbered List

The same rules as the plain list, just a different identifier (plus).

1. one

2. two

3. three

   - mixed lists!

   - what a mess

     1. counting again

     2. ...

4. four

### Definition List

The definition list identifier is a colon, followed by the term. The term contents is placed on the next line.

orange

  a yellow fruit

apple

  a green or red fruit

other fruits

  - wee!

  - mixing lists

    1. again!

    2. and again!

## Tables

Use pipes to compose table rows and cells. Double pipe at the line beginning starts a heading row. Natural spaces specify each cell alignment.

     || heading 1 |  heading 2  |  heading 3 |
      | cell 1.1  |  cell 1.2   |   cell 1.3 |
      | cell 2.1  |  cell 2.2   |   cell 2.3 |

Without the last pipe, no border:

     || heading 1 |  heading 2  |  heading 3
      | cell 1.1  |  cell 1.2   |   cell 1.3
      | cell 2.1  |  cell 2.2   |   cell 2.3

## Special Entities

Because things were too simple.

### Images

The image mark is as simple as it can be: `[filename]`.

- The filename must end in PNG, JPG, GIF, or similar.

- No spaces inside the brackets!

### Other

The handy `%%date` macro expands to the current date.

So today is 20101031 on the ISO `YYYYMMDD` format.

You can also specify the date format with the %? flags, as `%%date(%m-%d-%Y)` which gives: 10-31-2010.

That's all for now.

(sample.t2t)