DESIGN.MD Help
Find answers or browse by topic
Create DESIGN.md specs from your Figma design: start from your variables or selection, refine tokens with AI, assign the spec to frames and share the file.
Popular Guides
-
CREATE A DESIGN.MD
Create a DESIGN.md file from your Figma design Click + New and start from your selection, the current page, your variables, an empty scaffold or a built-in example, then edit and save it.
-
AI
Draft and change a DESIGN.md with AI Add an API key for Groq, OpenAI or Google Gemini, then let the AI draft a DESIGN.md from a website or change named tokens such as colors.primary in chat.
-
ASSIGN TO FRAMES
Assign a DESIGN.md to frames and recolor them Save the document, select frames, and click Assign. The layers are linked to the DESIGN.md and take on its palette; Reset assignment brings the old colors back.
-
IMPORT & SHARE
Import DESIGN.md files and share them with others Drop .md files onto the plugin to add them to your library, decide what happens with duplicates, and download a DESIGN.md from the Design system panel to pass it on.
Topics
- Create a DESIGN.md Start from an example, your selection, the page, your variables or an empty scaffold.
- AI Connect an AI provider, draft from a website and change tokens in chat.
- Assign to Frames Link a DESIGN.md to frames and recolor them with its palette.
- Import & Share Bring DESIGN.md files in and get them to other people.
Frequently asked questions
Which AI providers does design.md creator support?
Groq, OpenAI and Google Gemini, with your own API key.
Can the AI review my whole DESIGN.md?
No. The chat does not receive the document's text, so it cannot review or rewrite the prose. It can set token values by path.
Does the AI cost anything?
Requests run on your own provider key, so your provider bills them under your account.
Does assigning change my frames permanently?
It recolors them, which you can reverse with Reset assignment, or with Undo right away.
Can teammates open the DESIGN.md from an assigned frame?
Only if the same document is in their library too, because each person's library is stored on their own computer. Send them the DESIGN.md file to import.
What is a DESIGN.md file?
A Markdown file that describes a design system: design tokens such as colors, type, spacing and radii in a YAML block at the top, followed by written guidance such as an overview, components and do's and don'ts. AI coding tools can read it to build interfaces in that style.
Which scan should I use?
Variables when your file uses variables and text styles; it gives the most complete, structured document. Selection or Current page when the design lives in layers and fills; they list what they find without prose.
Are hidden layers scanned?
No. Hidden layers are skipped, and only the first mode of each variable is read.
Does design.md creator connect to Google Stitch?
No. It writes DESIGN.md files; it has no connection to Google Stitch or other tools.
Is my DESIGN.md library saved in the Figma file?
No. It is stored on your computer for your Figma account, so teammates who open the file do not see it. Share documents as files.
Can I export from the library screen?
Downloading happens in the Design system panel. The library and the editor have no export button.