GUIDE 6 — STRUCTURE

home | guide index


blockquotes

marktxt

plain is safe. formatting is opt-in.
;< plain is safe. formatting is opt-in. ;.

markdown

> plain is safe. formatting is opt-in.

markdown uses > — the same character used for shell redirects, xml tags,
and comparison operators.

html

<blockquote>plain is safe. formatting is opt-in.</blockquote>

dividers

marktxt

;& ;.

renders as a horizontal rule:


markdown

---

markdown uses --- — also used as yaml frontmatter delimiters and
visual separators in plain text docs. easy to trigger by accident.

html

<hr>

tables

marktxt

namerolestatus
alicedesigneractive
bobdeveloperactive
carolmanageraway
;[ name ;t. ;[ role ;t. ;[ status ;t.
;[ alice ;t. ;[ designer ;t. ;[ active ;t.
;[ bob ;t. ;[ developer ;t. ;[ active ;t.
;[ carol ;t. ;[ manager ;t. ;[ away ;t.

first row = header. one ;[ per cell, closed with ;t. — clean and readable.

markdown

| name  | role      | status |
|-------|-----------|--------|
| alice | designer  | active |
| bob   | developer | active |
| carol | manager   | away   |

markdown tables need alignment rows and pipe characters on every line.

html

<table>
  <tr><th>name</th><th>role</th><th>status</th></tr>
  <tr><td>alice</td><td>designer</td><td>active</td></tr>
  <tr><td>bob</td><td>developer</td><td>active</td></tr>
  <tr><td>carol</td><td>manager</td><td>away</td></tr>
</table>

comments

marktxt

;# this is a comment — it wont render ;.

comments are invisible in the rendered output. useful for notes to yourself.

markdown

<!-- this is a comment -->

markdown uses html comments — verbose and easy to forget to close.

html

<!-- this is a comment -->

same as markdown.


explicit line breaks and paragraphs

besides plain text auto-detection, you can use explicit operators:

;! ;.          explicit line break
;~ text ;.     explicit paragraph

;! forces a break anywhere. ;~ text wraps text in a paragraph tag.
useful when you want precise control instead of auto-detection.


the full picture

marktxt gives you a spectrum:

start simple. add complexity only when you need it.

plain is safe. formatting is opt-in. that is the whole idea.

prev: links and media | next: full element reference