> For the complete documentation index, see [llms.txt](https://docs.taskade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taskade.com/workspaces/workspaces/markdown.md).

# Markdown Support

***

## Table of Contents

* [Overview](#overview)
* [Where Markdown Works in Taskade](#where-markdown-works-in-taskade)
* [Supported Syntax Reference](#supported-syntax-reference)
* [Markdown in the Project Editor](#markdown-in-the-project-editor)
* [Markdown in Chat & Comments](#markdown-in-chat--comments)
* [Markdown in Agent Chat](#markdown-in-agent-chat)
* [Markdown in AI Project Studio](#markdown-in-ai-project-studio)
* [Markdown in Browser Widgets & Quick Add](#markdown-in-browser-widgets--quick-add)
* [Import & Export Markdown](#import--export-markdown)
* [Add Markdown to Agent Knowledge](#add-markdown-to-agent-knowledge)
* [What's Next](#whats-next)

***

## Overview

Markdown is a lightweight markup language that uses characters like `*`, `#`, and `-` to format text. Taskade supports Markdown across **7 different surfaces** — from the project editor to AI agent chats, import/export, and browser widgets.

***

## Where Markdown Works in Taskade

| Surface               | What Markdown Does                                                         |
| --------------------- | -------------------------------------------------------------------------- |
| **Project editor**    | Format tasks, checklists, headings, and paragraphs inline                  |
| **Import/Export**     | Convert `.md` docs to projects and projects to `.md` files                 |
| **AI Project Studio** | Add `.md` files as context for AI-generated projects                       |
| **AI Agents**         | Fine-tune agents using Markdown knowledge; structure prompts in agent chat |
| **Chat & Comments**   | Format team messages and task comments                                     |
| **Quick Add widget**  | Add formatted notes and tasks from the desktop/browser widget              |
| **Genesis Context**   | Upload `.md` files as app-building context                                 |

***

## Supported Syntax Reference

### Inline Formatting

| Feature           | Syntax               | Rendered Output      |
| ----------------- | -------------------- | -------------------- |
| **Bold**          | `**bold text**`      | **bold text**        |
| **Italic**        | `_italic text_`      | *italic text*        |
| **Underline**     | `__underlined__`     | underlined           |
| **Strikethrough** | `~~strikethrough~~`  | ~~strikethrough~~    |
| **Inline code**   | `` `code` ``         | `code`               |
| **Block quote**   | `> quoted text`      | > quoted text        |
| **Code block**    | ` ```code block``` ` | Formatted code block |

### Block Formatting (Project Editor)

Type these at the beginning of a line followed by a space:

| Syntax         | Result        | Description         |
| -------------- | ------------- | ------------------- |
| `#`            | H1 heading    | Large section title |
| `##`           | H2 heading    | Sub-section title   |
| `-`            | Bullet list   | Unordered list item |
| `1.` `2.` `3.` | Numbered list | Ordered list items  |
| `[]`           | Checklist     | Checkbox task item  |

### Links

| Feature            | Syntax             | Description          |
| ------------------ | ------------------ | -------------------- |
| **Workspace link** | `"workspace link"` | Links to a workspace |
| **Project link**   | `"project link"`   | Links to a project   |
| **Web link**       | `[text](url)`      | Standard hyperlink   |

***

## Markdown in the Project Editor

Type Markdown syntax directly while editing tasks:

| Action               | How                                     |
| -------------------- | --------------------------------------- |
| Create heading       | Type `#` or `##` at the start of a line |
| Create bullet list   | Type `-` at the start of a line         |
| Create numbered list | Type `1.` at the start of a line        |
| Create checklist     | Type `[]` at the start of a line        |
| Bold text            | Wrap text in `**double asterisks**`     |
| Italic text          | Wrap text in `_underscores_`            |
| Code block           | Wrap text in ` ``` `                    |

***

## Markdown in Chat & Comments

### Chat

| Step | Action                               |
| ---- | ------------------------------------ |
| 1    | Open the project chat box            |
| 2    | Wrap your message in Markdown syntax |
| 3    | Taskade renders the formatted text   |

### Comments

| Step | Action                                                         |
| ---- | -------------------------------------------------------------- |
| 1    | Select a task → Click **+** → Select **Comments** (or press C) |
| 2    | Type your comment with Markdown syntax                         |
| 3    | Click send — Markdown is rendered                              |

***

## Markdown in Agent Chat

Use Markdown to structure prompts and get better AI responses:

| Technique        | Example                                                         | Use Case                          |
| ---------------- | --------------------------------------------------------------- | --------------------------------- |
| **Emphasis**     | `Fields marked with **bold** are mandatory.`                    | Highlight important instructions  |
| **Code blocks**  | ` ```python\ndef calculate(): ... ``` `                         | Ask AI to analyze or debug code   |
| **Lists**        | `1. Download installer\n2. Accept license\n3. Choose directory` | Define step-by-step instructions  |
| **Block quotes** | `> "Success is not final..."`                                   | Emphasize key quotes or reminders |

***

## Markdown in AI Project Studio

Use `.md` files as context for AI-generated projects:

| Step | Action                                                |
| ---- | ----------------------------------------------------- |
| 1    | Click **+ Create new** → **AI Project**               |
| 2    | Describe the project you want                         |
| 3    | Click the upload dropdown → **Upload Files**          |
| 4    | Upload your `.md` files as context                    |
| 5    | Generate the project — AI uses your Markdown as input |

***

## Markdown in Browser Widgets & Quick Add

| Method                | Steps                                                                      |
| --------------------- | -------------------------------------------------------------------------- |
| **Browser extension** | Right-click Taskade Extension → Add content with Markdown → Choose project |
| **Quick Add widget**  | Open Quick Add → Write Markdown → Choose target project                    |

***

## Import & Export Markdown

### Import

| Method          | Steps                                                                     |
| --------------- | ------------------------------------------------------------------------- |
| **File upload** | **+ Create new** → **Import** → Drag `.md` files or click upload          |
| **Paste**       | **+ Create new** → **Import** → **Paste Text & Markdown** → Paste content |
| **Direct**      | Visit `taskade.com/create` to start instantly                             |

### Export

| Step | Action                                                    |
| ---- | --------------------------------------------------------- |
| 1    | Click the three dots (⋯) at the top-right of your project |
| 2    | Select **Export** → Choose **Markdown**                   |
| 3    | Download the `.md` file                                   |

***

## Add Markdown to Agent Knowledge

Create Markdown knowledge sources directly in your agent:

| Step | Action                                                   |
| ---- | -------------------------------------------------------- |
| 1    | Go to **Agents** tab → Click three dots → **Edit agent** |
| 2    | Open the **Knowledge** tab                               |
| 3    | Click **Add Markdown/Text**                              |
| 4    | Paste Markdown or plain text into the pop-up             |
| 5    | Click **Add to Knowledge**                               |
| 6    | Click **Update** in the Knowledge tab to save            |

***

## What's Next

| Guide                                                                | What You'll Learn       |
| -------------------------------------------------------------------- | ----------------------- |
| [Import](/workspaces/workspaces/import.md)                           | Full import walkthrough |
| [Editing & Formatting](/workspaces/workspaces/editing-formatting.md) | All formatting options  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.taskade.com/workspaces/workspaces/markdown.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.