Bring content in

To bring existing notes into Knit, paste them into a page. Knit keeps their structure.

On a new, untouched page, a complete document with one heading above all its section headings uses that heading as the page title. It can be an H1 or a shallower heading than the document's sections, such as one H2 above several H3s. Knit removes that heading from the body and keeps the rest editable. If several headings share the highest level, they stay in the body. Pasting into an existing page never changes its title.

Paste from another document

Copy from a web page or another document editor and paste into a Knit page. Headings, lists, tables, links, quotes, and code come across as the same kinds of blocks in Knit.

Paste Markdown

Paste Markdown as plain text, for example from a .md file or a code editor. Knit recognizes headings, lists, quotes, links, code blocks, and tables, and turns them into formatted blocks rather than leaving the raw symbols.

If the file starts with YAML frontmatter, Knit keeps that metadata in an editable code block above the formatted document.

Example. Paste this Markdown into a page:

## First week

- Meet your onboarding buddy
- Read the [team handbook](https://acme.knit.wiki/handbook)

> Ask questions early. Nobody expects you to know everything yet.

```sh
git clone git@github.com:acme/app.git
```

git clone git@github.com:acme/app.git

Paste HTML source

Paste HTML source from a file or another tool into a page. Knit turns supported headings, paragraphs, lists, and tables into editable content rather than leaving the tags as text. You can keep writing and change the formatting in Knit.

Paste code

Code copied from VS Code stays code: Knit puts it in a code block. (Markdown copied from VS Code is formatted as described above.) Anything you paste inside an existing code block stays exactly as you pasted it.

Paste a link

Paste a web address and it becomes a link. Select some words first, then paste, to turn those words into a link.

Images

To add images, see Images.

After pasting

Pasted content is part of your draft like anything else you type. Select Publish when it's ready. If something didn't come across the way you wanted, press ⌘Z (Ctrl+Z) to undo the paste.