💾 Archived View for gemini.veillance.xyz › guides › gemtext_markup_guide.gmi captured on 2023-11-04 at 11:23:01. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

A Guide to Gemtext Markup for Gemini

Gemtext is a lightweight markup language used for content on the Gemini protocol. Its design is minimalist, making it straightforward to learn and use.

Headers

Headers are created with the `#` symbol. Gemtext supports three levels of headers:

# This is a level 1 header
## This is a level 2 header
### This is a level 3 header

Links

Linking is simple. Start the line with `=>` followed by a space, then the URL and an optional description.

=> https://example.com This is a link to example.com!

Lists

Gemtext supports unordered lists. Each list item starts with `*` followed by a space.


	Item 1
	Item 2
	Another item

Blockquotes

For quoting blocks of text, Gemtext uses a line that starts with `>`.

> This is a blockquote. It's great for emphasizing or setting apart a section of text.

Preformatted Text

Text can be presented in a preformatted block by starting and ending with three backticks. This is useful for code, tables, etc.

 ```
This is preformatted text.
Everything will appear as typed,
     including spaces and line breaks.

 ```

Text Lines

Any other lines are treated as plain text paragraphs.

This is a text line. Note that in Gemtext, there are no text emphasis elements like bold or italic. The simplicity is a feature, not a bug!

Line Breaks

To create a line break, just use an empty line.

This is a paragraph.
And this is another one, separated by a line break.

Wrapping up

That's the essence of Gemtext. Its simplicity is its strength. While it may not offer the rich features of HTML, its minimalism makes it perfect for focused, distraction-free content delivery on the Gemini protocol.

Enjoy writing in Gemtext!