GUIDE 1 — PLAIN TEXT

home | guide index


the big idea

in marktxt, plain text is just text.
no special characters hijack your words.
single enter = line break. double enter = new paragraph.


line breaks

marktxt

the rain came down hard.
she closed the window.
the room went quiet.

just type. each line stays on its own line.

markdown

the rain came down hard.
she closed the window.
the room went quiet.

markdown collapses these into one line.
you need two trailing spaces or a
tag to force a line break.

html

<p>the rain came down hard.<br>
she closed the window.<br>
the room went quiet.</p>

html needs explicit
tags for every line break.


paragraphs

marktxt

first paragraph here.
still the same paragraph.

second paragraph starts after an empty line.

empty line = new paragraph. simple.

markdown

first paragraph here.
still the same paragraph.

second paragraph starts after an empty line.

markdown does the same for paragraphs — but remember, single enters are ignored.
your source text and rendered output look different.

html

<p>first paragraph here.
still the same paragraph.</p>

<p>second paragraph starts after an empty line.</p>

html needs

tags around every paragraph.


mixing plain text with operators

plain text and operators live together. no conflict.

the old keeper climbed the stairs.
she carried a heavy brass lamp.
the flame was barely alive

the old keeper climbed the stairs.
she carried a ;^ heavy ;. brass lamp.
the flame was ;% barely alive ;.

plain text flows naturally. operators add formatting only where you want it.


the markdown trap

in markdown, plain text is a minefield:

use my_variable_name       <- markdown makes "variable" italic
run the ** glob pattern    <- markdown sees bold trigger
check the # in the config  <- markdown sees heading trigger
pipe output > to file      <- markdown sees blockquote

in marktxt, all of the above stays exactly as typed.
nothing triggers unless you type ; first.


prev: guide index | next: headings