Hub Usage

Markdown Syntax

How to use Markdown with TTT.

Your knowledge sharing hub uses markdown to help you format the content that will automatically be rendered on your content site without having to leave your IDE. We support most Markdown formatting options. In this page you can find a cheatsheet to the most common ones.

Titles

Use titles to introduce main sections. They structure your content and help users navigate pages easily.

## Section Title
We recommend using the front matter on each document to specify the main title of the page H1 (#). You can use markdown to specify H2 (##) and H3 (###).
H1 are formatted accordingly but ignored on the table of sections to the right.

Subtitles

Use subtitles to divide sections further. They create a more detailed content hierarchy for better readability.

### Section Subtitle
Each section title (h2) and subtitle (h3) creates an anchor and shows up in the table of sections. Subtitles are automatically indented.

Text Formatting

Improve the readability of your content with markdown.

StyleHow to useResult
Bold**bold**Bold
Italic*italic*Italic
Strike~~strike~~Strike

Combine formatting for richer text styles and visual emphasis.

StyleHow to useResult
Bold Italic**_bold italic_**Bold Italic
Bold Strike~~**bold**~~Bold
Italic Strike~~*italic*~~Italic

For exponents, indices, or mathematical notations, use HTML <sup> and <sub> tags.

StyleHow to useResult
Superscript<sup>superscript</sup>superscript
Subscript<sub>subscript</sub>subscript

Links connect different parts of your content and external resources, essential for user navigation and providing references. To create a link, wrap the link text in brackets []().

[TTT](http://team.teaches.team)

For linking within your content, use root-relative paths like /playbook/usage/markdown-syntax.

[Playbook - Markdown Syntax](/playbook/usage/markdown-syntax)

Lists

Organize related items in a structured, readable format. Markdown supports unordered, ordered, and nested lists for various content needs.

Unordered

Use unordered lists for items without a specific sequence. Start each item with a - symbol.

  • I'm a list item.
  • I'm another list item.
  • I'm the last list item.
- I'm a list item.
- I'm another list item.
- I'm the last list item.

Ordered

Use ordered lists when item order matters, like steps in a process. Start each item with a number followed by a dot.

  1. I'm a list item.
  2. I'm another list item.
  3. I'm the last list item.
1. I'm a list item.
1. I'm another list item.
1. I'm the last list item.
You can use 1. for all items and have them render correctly. Saving you the hassle of updating the whole list in case of changes.

Nested

Create hierarchical lists with sub-items for complex structures. Indent sub-items by four spaces for nesting.

  • I'm a list item.
    • I'm a nested list item.
    • I'm another nested list item.
  • I'm another list item.
- I'm a list item.
  - I'm a nested list item.
  - I'm another nested list item.
- I'm another list item.
Nesting only works with unordered lists, just like in standard markdown. You also cannot mix ordered and nested unordered lists.

Tables

Present structured data in rows and columns clearly. Tables are ideal for comparing data or listing properties.

PropDefaultType
namestring
sizemdstring
colorneutralstring
| Prop        | Default   | Type     |
|-------------|-----------|----------|
| **_name_**  |           | `string` |
| **_size_**  | `md`      | `string` |
| **_color_** | `neutral` | `string` |

Blockquotes

Highlight important quotations, citations, or emphasized text. Blockquotes visually distinguish quoted content.

Singleline

Single-line blockquotes are best for short, impactful quotes or citations that fit within a single line. To create a single-line blockquote, add a > in front of a sentence.

Knowledge is power. Knowledged shared is powered multiplied! -Robert Boyce

> Knowledge is power. **Knowledged shared is powered multiplied!** *-Robert Boyce*

Multiline

Multi-line blockquotes are suitable for longer quotes or when you need to include multiple paragraphs within a single quotation.

Knowledge is like money: to be of value it must circulate, and in circulating it can increase in quantity, and hopefully, in value.

Louis L'Amoar

> Knowledge is like money: to be of value it must circulate, and in circulating it can increase in quantity, and hopefully, in value. 
> 
> **_Louis L'Amoar_**