# Formatting

Markdown .md pages are plain text documents with a simple human readable syntax that aims to make writing for the internet easier.

No special software is required to create an .md file. Any basic text editor will do. Just save the file with a .md file extension.

Please see markdownguide.org for a full demonstration of the formatting possibilities and best practices.

View the actual formatting.md file used to create this page.


# Quick start

The following sample demonstrates a very basic .md page sample with page title and one paragraph.

# Page title here

This is a paragraph.

We can build on the above sample by adding more content and formatting, such as bold text, images, and lists.

# Page title here

This is a paragraph.

Both [internal](README.md) and [external](https://example.com) links work.

![Your logo](logo.png)

Another paragraph with **bold**, _italic_, ~~strikethrough~~, and `code` samples.

---

## Lists

- First item
- Second item
- Third item

1. First item
2. Second item
3. Third item

> "Cool! This is a quotation."

!!!
Need to draw attention to something? Use an alert.
!!!

At a very basic level, to create a new page for your Retype project, do the following:

  1. Make a new sample.md file
  2. Add a # title
  3. Start writing

# Editing the landing page

You may see that the landing page for your Retype project is blank. You can change this by simply renaming the Markdown file from whatever it is to readme.md. Retype will automatically reconfigure the website to make the landing page match the content on readme.md.


# Components

In addition to the standard Markdown options, Retype includes many custom components so you can easily add extra 💎 flair 💎 to your document.

The most commonly used Retype components include Alert and Tab:

# Alert

This is an Alert

Sample Alert component
!!!
This is an Alert
!!!

# Tab

This is Tab 1

This is another Tab

Sample Tab component
+++ Tab 1
This is Tab 1
+++ Tab 2
This is another Tab
+++

See all components
/components