TalePal

Writing Day One

Your workspace is set up. Now let's get words on the page.

Story Foundation

Before writing, you can define the core elements of your story. Click Building your Story Foundation from the welcome screen (or use the command palette: TalePal: Open Story Foundation).

The Story Foundation wizard captures five essentials:

  • Working Title — you can change this anytime
  • Core Idea — your premise in 1-2 sentences
  • Genre — click once for main genre, again for sub-genre
  • Main Character — name, role, brief description
  • World & Setting — where and when the story takes place

Story Foundation

Fill in what you know. Skip what you don't — you can come back and refine later. The foundation feeds into every conversation you have with TalePal, so the AI always knows what your story is about.

Writing chapters

Chapters live in talepal/chapters/ as Markdown files. You can:

  • Import existing files — click Importing existing chapters from the welcome screen, or drag .md files into the talepal/chapters/ folder
  • Create a new chapter — click Creating your first chapter from the welcome screen, or use the + button in the Story/Chapters tree

Each chapter is a plain Markdown file. Write freely — TalePal doesn't impose any structure on your prose. Use headings, italics, bold, blockquotes — whatever serves the story.

Writing a chapter

Chapter management

The Story / Chapters tree in the left sidebar shows all your chapters in order. You can:

  • Reorder chapters with the up/down arrows
  • Rename chapters
  • Add a front cover (a special front-cover.md file — used by EPUB export)

After importing or creating chapters, TalePal tracks them automatically. The sidebar updates as you add files.

Sidebar with chapters

Markdown basics

If you're new to Markdown, here's what you need:

Syntax Result
# Chapter Title Heading
**bold text** bold text
*italic text* italic text
--- Horizontal rule (scene break)
> quoted text Blockquote
![alt](path) Image

VS Code renders Markdown preview with Cmd+Shift+V (or the preview icon in the tab bar).

What happens when you save?

When you save a chapter file, TalePal:

  • Updates the chapter registry (tracks file names, order, word counts)
  • Makes the chapter available as context for AI conversations
  • Reflects changes in the Story/Chapters sidebar

No manual "sync" needed — just save and write.

Next steps

You have a foundation and chapters. Now use the AI to develop your story:

  • Chat UI — learn how to talk to TalePal effectively
  • Pingpong Modes — choose the right creative partner mode for what you're working on

Next: Chat UI — master the chat panel, prompts, and @-mentions.