====== Gemtext ======

The native document format for [[protocols:gemini:start|Gemini]]. Line-oriented — the first characters of each line determine its type.

===== Syntax Reference =====

^ Prefix ^ Type ^ Notes ^
| ''# '' | H1 heading | |
| ''## '' | H2 heading | |
| ''### '' | H3 heading | |
| ''=> URL'' | Link | One per line; no inline links |
| ''=> URL Text'' | Link with label | |
| ''* '' | List item | Unordered only |
| ''> '' | Blockquote | |
| ''` `` `'' | Preformatted toggle | Everything between two toggles is literal |
| (anything else) | Body paragraph | |

===== Design Constraints =====

  * No inline formatting — no bold, italic, or inline code
  * No nested lists
  * No images (links to images are fine)
  * One link per line — forces deliberate linking
  * These constraints encourage clearer, more direct writing

===== Subscription Convention =====

Gemlogs use ''YYYY-MM-DD'' at the start of link labels so clients can detect and subscribe to new entries automatically:

<code>
=> /posts/2026-05-26-post.gmi 2026-05-26 Post title
</code>

===== See Also =====

  * [[protocols:gemini:start|Gemini]]
  * [[https://geminiprotocol.net/docs/gemtext-specification.gmi|Official gemtext specification]]
  * [[protocols:start|Return to protocols]]