Formatting Your Project Description
Your project's Full Description supports Markdown, a simple way to add headings, lists, links, images, and even embedded videos using plain text. Type the description in the project's Create or Edit form; it renders formatted on the project page.
You don't need to learn all of it. Plain text works fine on its own. Reach for these when you want more structure.
Text Styling
| You type | You get |
|---|---|
**bold text** |
bold text |
__italic text__ |
italic text |
~~strikethrough~~ |
Headings
Start a line with two to six # characters, followed by a space. More hashes means a smaller heading.
## Section Title
### Subsection
Lists
Bulleted — start each line with - (or +):
- First point
- Second point
Numbered — start each line with 1.:
1. Set up the board
2. Deal three cards
3. Youngest player goes first
Quotes and Dividers
> A quote or callout, indented with a bar.
---
A line of three or more dashes (---) draws a horizontal divider.
Links
[The Game Crafter](https://www.thegamecrafter.com)
Links must start with http:// or https://. Bare URLs you paste on their own also become clickable automatically.
Images
- The text in the square brackets is the alt text (shown if the image can't load).
- The link in the parentheses is the image's web address (
https://…). - To float an image beside text, add
leftorright:. - To make an image clickable, wrap it in a link:
[](https://yoursite.com).
Embedding Videos
Paste a YouTube or Vimeo link on its own line and it turns into an embedded, playable video:
https://www.youtube.com/watch?v=XXXXXXXXXXX
https://vimeo.com/123456789
youtu.be/… short links work too. Videos are embedded in privacy-friendly mode and sized to fit the page automatically.
Note
Descriptions use Markdown only, not HTML. If you paste HTML tags or an embed code from another site, they'll simply show as plain text rather than doing anything. To add a video, paste a YouTube or Vimeo link (above). This keeps public project pages safe for everyone.
A Full Example
## About the Game
**Reef Rush** is a *fast, tactical* game of building coral and outwitting rivals.
- 2 to 4 players
- 30 to 45 minutes
- Ages 10+
Watch the 90-second overview:
https://www.youtube.com/watch?v=XXXXXXXXXXX
Read the full rules on [our site](https://example.com/rules).