Need AI Training/Help?CloudYeti.io/meet
MarkdownMe
Markdown to ClickUp guide

How to Paste Markdown Into ClickUp Docs

ClickUp Docs turns pasted Markdown into a raw code block instead of formatted text. Convert the Markdown to rich HTML first, copy it as rich text, then paste into the Doc.

Direct answer

ClickUp Docs does not parse Markdown on paste. It reads the pasted text as plain text and usually drops the whole block into a code block, so you see raw # and ** characters in a grey box. Convert the Markdown to rich HTML first, press Copy Rich, then paste into the Doc. ClickUp reads the HTML on the clipboard and builds real headings, bold text, lists, tables, and links.

Open Markdown to ClickUp converter

When to use this

  • A pasted Markdown document lands in ClickUp Docs as one grey code block.
  • Headings and bullets from a README, spec, or AI answer must become real Doc blocks.
  • You are moving notes out of Obsidian, Notion export, or a repo into a ClickUp Doc.

Steps

  1. Copy the Markdown source, including headings, bullets, links, and tables.
  2. Paste it into the Markdown input box on this page.
  3. Check the preview on the right — that is what ClickUp receives.
  4. Press Copy Rich. It writes formatted HTML and a plain-text fallback to the clipboard.
  5. Click into the ClickUp Doc and paste normally with Ctrl+V or Cmd+V.

Example conversion

Markdown input
# Launch checklist

Owner: **Priya**

## Before release

- Run the smoke suite
- Freeze the `main` branch
- Post the [release note](https://example.com/notes)

## After release

1. Watch error rate for 30 minutes
2. Close the sprint
ClickUp paste HTML output
<h1 style="font-family:-apple-system,'Segoe UI',Roboto,sans-serif;font-size:22px;font-weight:600;margin:18px 0 8px;color:#171717;">Launch checklist</h1>
<p style="font-family:-apple-system,'Segoe UI',Roboto,sans-serif;font-size:14px;line-height:1.5;color:#242424;margin:10px 0;">Owner: <strong>Priya</strong></p>
<h2 style="font-family:-apple-system,'Segoe UI',Roboto,sans-serif;font-size:18px;font-weight:600;margin:16px 0 8px;color:#171717;">Before release</h2>
<ul style="font-family:-apple-system,'Segoe UI',Roboto,sans-serif;font-size:14px;line-height:1.5;color:#242424;margin:10px 0;padding-left:22px;"><li style="margin:4px 0;">Run the smoke suite</li><li style="margin:4px 0;">Freeze the <code style="font-family:Consolas,'Courier New',monospace;font-size:13px;background:#f3f3f3;padding:2px 5px;border-radius:3px;">main</code> branch</li><li style="margin:4px 0;">Post the <a href="https://example.com/notes" style="color:#0f6cbd;text-decoration:underline;">release note</a></li></ul>
<h2 style="font-family:-apple-system,'Segoe UI',Roboto,sans-serif;font-size:18px;font-weight:600;margin:16px 0 8px;color:#171717;">After release</h2>
<ol style="font-family:-apple-system,'Segoe UI',Roboto,sans-serif;font-size:14px;line-height:1.5;color:#242424;margin:10px 0;padding-left:22px;"><li style="margin:4px 0;">Watch error rate for 30 minutes</li><li style="margin:4px 0;">Close the sprint</li></ol>

Common mistakes

  • Do not paste raw Markdown into a Doc and expect ClickUp to convert it — ClickUp has no Markdown paste mode.
  • Do not use Paste as plain text (Ctrl+Shift+V). That drops the HTML and gives you the raw characters again.
  • Do not expect the Copy HTML button to work in a Doc. That button copies the HTML source as text, which is only useful outside ClickUp.

FAQ

Does ClickUp support Markdown?
ClickUp supports some Markdown shortcuts while you type in a Doc, such as typing ## followed by a space. It does not parse Markdown that arrives through the clipboard. Pasted Markdown stays literal, and in many cases ClickUp wraps the whole paste in a code block.
Why does my paste become a code block?
ClickUp inspects the clipboard. When it sees only plain text with newlines and symbols, it often chooses a code block to preserve the text exactly. Putting HTML on the clipboard instead gives ClickUp real block types to build.
What does Copy Rich put on the clipboard?
Two things: inline-styled HTML as text/html, and a Markdown-stripped plain-text version as text/plain. ClickUp reads the HTML. Apps that only accept plain text get the readable fallback.
Does this work in task descriptions too?
Yes. The task description editor and the Doc editor both accept pasted rich text, so the same Copy Rich paste works in either place.

Related ClickUp guides

ClickUp Turns Pasted Markdown Into a Code Block — Fix

Pasting Markdown into ClickUp drops it into a single code block. The cause is a plain-text clipboard. Paste rich HTML instead and the blocks render.

How to Put ChatGPT Output Into a ClickUp Task

ChatGPT answers are Markdown. Pasted into a ClickUp task description they show raw ## and ** characters. Convert first, then paste as rich text.

How to Get a Markdown Checklist Into ClickUp

Markdown task syntax with - [ ] does not become ClickUp checklist items on paste. Convert to a clean bullet list, paste it, then convert the list to a checklist in ClickUp.

How to Format an AI-Written Doc for ClickUp

Turn a long AI-written Markdown document into a properly formatted ClickUp Doc: headings, tables, quotes, and code stay intact through one rich paste.