# TXT2TAGS SAMPLE

## Aurelio Jargas

### 10/31/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.

(-)