Guide for first-time book writers

This tool is built to turn your notes into chapters and walk you, step by step, toward a finished book. Pick a chapter on the left, feed it with notes — research outputs, syntheses, quotes — and when the material is ripe, write the draft. Below: how to work in this tool, the universal craft of clear writing, source ethics, and what happens to your files.

Suggested workflow

Collect. Add everything that comes out of your research and reading to the relevant chapter as a note. Do not judge yet — accumulate. Collecting and writing are different jobs, and mixing them slows both down.

Synthesize. Once notes pile up, write synthesis notes that answer one question: "what is the main idea of this chapter?" Save diagram and illustration ideas as visual notes — at book-design time you will have a ready list.

Write. Draft with your syntheses in view: notes at your right hand, draft in front of you. When bringing text from outside, the Paste button cleans line breaks and residue; Clean up applies the same cleanup to a selection; the Editor button adds headings, lists, block quotes and smart punctuation in one pass — and Undo reverts it. The B / I / H / List / ❝ buttons format the selected text. Need silence? Focus mode hides both panels; Esc brings them back.

Rest and revise. Let a chapter rest for at least a week before marking it "done", then reread it with a stranger's eyes. Distance is the cheapest editor you will ever hire.

Undecided? Throw anything that has no home yet into the Scratchpad; when it is ready, send it where it belongs with "move to chapter".

🎤 Voice notes: Click the microphone button next to note fields and the draft toolbar and speak — your words become text; click again to stop. (Speech recognition uses the browser's service; Chrome/Edge required, microphone permission asked on first use.)

The craft: writing clearly, in any language

One paragraph, one idea. The paragraph is the unit of thought. If a paragraph runs long, it is probably carrying two ideas — split it.

Short sentences win. One sentence should carry one idea; let the reader breathe. Vary length for rhythm, but when in doubt, cut the sentence in two.

Prefer the active voice. "The team defined the problem" is alive; "the problem was defined" hides the actor. Use the passive only when the actor truly does not matter.

Show, don't only tell. "The warehouse was chaotic" is a claim; "three forklifts blocked the same aisle" is a scene. Concrete detail persuades where adjectives cannot.

Cut ruthlessly. Every word that does no work weakens the words that do. If a sentence survives without a word, the word goes.

First drafts are supposed to be rough. Write the draft to find out what you think; rewrite it so the reader thinks it too. Never edit while drafting — they are different mental modes.

Read it aloud. A sentence that trips your tongue will trip your reader. The ear catches what the eye forgives.

Write for one reader. Pick a single, real person and explain it to them. A book written for "everyone" is written for no one.

Quoting & source ethics

Verbatim quote → quotation marks + source + page number. Quotes longer than 40 words become block quotes in the book.
Paraphrasing — restating an idea in your own words — also needs a source. The most common form of plagiarism is paraphrasing without citing.
Write [[source:kahneman2011]] in the draft; when the book is built it automatically becomes (Kahneman, 2011) and enters the Bibliography.
Avoid secondary quoting: instead of "According to Kahneman, Simon said…", go to the original source whenever possible.
Verify famous sayings before you use them: most quotes attributed to Einstein are not Einstein's. (A great side story for your book!)

The structure of a book

Preface

The story of the book: why and for whom you wrote it. Usually written last.

Introduction

The promise and a reading map. Within two pages the reader should know "what will this book give me?".

Chapters

Each chapter should answer a single question; write that question in the synopsis field before you draft.

Bibliography

Generated automatically — you just enter sources and use citation markers.

What happens when you build the book?

The "Build the Book" button at the bottom left produces your book in three formats: Markdown (raw text), HTML (reading/print preview) and Word (.docx) — with cover, table of contents, preface, introduction, chapters and an APA bibliography. When you open the Word file, confirm updating the table of contents (fields fill automatically). File names carry a date + time stamp; every build is a separate output version.

Snapshots & safety backup

The "Snapshot" button saves the current state of the book into the versions/ folder. Take a snapshot before any big change (deleting a chapter, restructuring); you can restore from the list with one click — the current state is also snapshotted automatically before restoring, so nothing is ever lost.

Your work is never wasted: on every save the latest state of your book is also written to yedek/kitap-son-hali.md and yedek/kitap-son-hali.docx — including your notes and scratchpad. Even if this app never opens again one day, you can open that Word file and continue where you left off.

The tool this guide describes is free and runs entirely on your own computer.

Download — free