From 3e5afbf5dd175dae01546e11213ce7c1652b7f31 Mon Sep 17 00:00:00 2001 From: Jeremy Singer Date: Wed, 6 May 2026 18:55:26 +0200 Subject: [PATCH] docs: add Markdown formatting guidance for project descriptions Adds an Artist FAQ entry covering supported Markdown (bold, italics, headers, links) and the   workaround for paragraph breaks, plus a cross-reference from the staging guide's description-writing section. Co-Authored-By: Claude Opus 4.7 --- creator-onboarding/artists/2-staging-and-testing.md | 2 ++ creator-onboarding/artists/faq.md | 13 +++++++++++++ 2 files changed, 15 insertions(+) diff --git a/creator-onboarding/artists/2-staging-and-testing.md b/creator-onboarding/artists/2-staging-and-testing.md index 1e1d11f5..d3f9b429 100644 --- a/creator-onboarding/artists/2-staging-and-testing.md +++ b/creator-onboarding/artists/2-staging-and-testing.md @@ -88,6 +88,8 @@ The project description is an important opportunity to highlight your intentions - Be sure to describe any interactivity features, if applicable. - End by summarizing how the medium, outputs, and algorithm achieve your initial inquiry or concept. +For Markdown formatting tips (bold, italics, headers, line breaks), see the [Artist FAQ](/creator-onboarding/artists/faq/#creator-dashboard). + --- ## Step 3: Scripts diff --git a/creator-onboarding/artists/faq.md b/creator-onboarding/artists/faq.md index 355050de..c64d0ae4 100644 --- a/creator-onboarding/artists/faq.md +++ b/creator-onboarding/artists/faq.md @@ -70,6 +70,19 @@ Please note that scripts containing multiple `Canvas` elements may not render as **I set up my payment splits wrong. Can I change them?** You can update payment configuration up until the project is locked. After locking, the royalty splitter is immutable — contact Art Blocks to request a splitter replacement. +**How do I format my project description? My line breaks aren't working.** +The description field renders standard Markdown: `**bold**`, `*italics*`, `#`/`##` headers, and links all work. Markdown collapses whitespace by design, so `
` tags and trailing double-spaces don't reliably create paragraph breaks. To force a visible blank line between paragraphs, put ` ` (a non-breaking space) on its own line: + +``` +First paragraph. + +  + +Second paragraph. +``` + +The Creator Dashboard preview can render slightly differently than the live collection page, so check the live page after publishing to confirm formatting looks right. + --- ## Staging and Testing