Beauty
Journal Field guides

Field guide / The finished page

From a working note to a finished page.

Markdown is a good format for writing and revising. PDF is useful when the next person needs a document they can simply open. Beauty lets you move from one to the other without rebuilding the page by hand.

In motionAn illustrated document in PDF, HTML, and Markdown. Export from the app to create the actual file for your note.

Choose the format for the reader

Markdown is compact, editable, and easy to keep in a folder. PDF serves a different purpose: it records a rendered page so the recipient can read it without configuring a Markdown renderer.

Use PDF for a proposal, a meeting summary, a handout, or a document being reviewed in a fixed form. Keep the Markdown original for revisions. A PDF is the delivered copy; the source is where the next edit should begin.

Beauty also exports HTML. That can be useful for a rendered document in a web workflow, while Markdown remains the best choice when someone else will continue editing the text.

Prepare the note before exporting

Give the document a clear title and a small number of meaningful headings. Check that lists belong under the right heading, tables are not wider than they need to be, and images have loaded correctly.

Long code lines and large diagrams deserve extra attention. A line that fits comfortably in a scrolling editor may not fit a printed page. Shorten lines where possible, simplify diagrams, or separate a large explanation into smaller parts.

For tables, prioritize the columns a reader needs to compare. The Markdown table guide covers alignment and compact structure.

Export from Beauty

  1. Open the note you want to send and review its content in the editor.
  2. Open Save & export, choose PDF, then select Export PDF.
  3. Save or share the generated file using the options your platform presents. In a browser, choose the PDF destination in the print dialog when it opens.
  4. Open the PDF itself and check the result before sending it.

The surrounding save and share controls differ between Mac, phones, and browsers. The important check is always the same: inspect the generated file, rather than assuming the editor's current viewport is the finished page.

Try a small example

This source includes a heading, emphasis, a table, and a task. Copy it into a note or download the Markdown file, then export it from Beauty. It gives you a small document for checking how the workflow behaves on your device.

markdown-to-pdf.md
# A small proposal

A little more room to think.

## The idea

Make the useful things **beautiful**.

## The plan

| Work | Owner | Status |
| --- | --- | --- |
| Outline | Ada | Ready |
| Review | Sam | Next |

## Next step

- [ ] Share the first draft.
Download .md

Check the page you are about to send

Open the PDF and look for the details that change the reading experience: a heading stranded at the bottom of a page, a table that has become too small, a cropped image, or a long code line that no longer fits.

Confirm that the title is correct and that any links the reader needs remain useful. If the document includes formulas or a diagram, inspect those in the exported file too. Exported output is the evidence of how a particular document renders.

If you revise the Markdown after checking the PDF, export a new copy. Give the delivered file a name that makes its purpose clear, and keep older versions only when they are useful to the recipient.

Keep an editable original

On Mac, Beauty's local library keeps the Markdown file on disk. In the browser, export an editable copy of important work as well as the PDF. Browser storage is local to that browser profile and can be cleared.

For documents with assets, preserve the library or an export that includes what the note needs. A finished PDF is useful for reading, but it should not become the only surviving version of writing you plan to change.

A place for your next thought

Start with a sentence.

The editor and local writing are free. No account required.

All stories ↗