Importing Recipes from the Web

Recipe Box can import a recipe from a URL or from pasted text, parsing out the title, ingredients, instructions, and other details, then let you review and edit everything before creating a ready-to-use recipe note in your vault.

Importing a Recipe

Run the Import recipe command (Command Palette → "Import recipe").
Choose From URL or From Text.
Fill in the form and optionally change the Save to folder field (defaults to your configured import folder, or your first recipe folder).
Click Import to parse the recipe.
Review the extracted fields - title, servings, times, description, ingredients, instructions, and nutrition - editing anything that needs fixing. Use ← Back to return to the input form if needed.
Click Save recipe.

Recipe Box creates a new note and opens it automatically in the Recipe View. If a note with the same name already exists in that folder, Recipe Box asks whether to overwrite it.

From URL

Paste the URL of a recipe page or a cooking video (YouTube or TikTok).

If the page publishes a ready-made recipe note as part of its structured data, Recipe Box downloads that note directly and uses it as-is, skipping HTML parsing entirely. This gives the most accurate result whenever a site offers it.
Otherwise, for ordinary recipe pages, Recipe Box reads the structured recipe data embedded in the page's HTML - title, image, servings, times, ingredients, instructions, and nutrition (when published).
For YouTube and TikTok links, Recipe Box fetches the page and parses the video's title and description as recipe text.
Instagram links aren't supported. Copy the recipe caption and use From Text instead.

Why a URL Import Might Fail

The site requires a login or paywall to view the recipe.
The page renders its content with JavaScript rather than including it in the initial HTML.
The page doesn't publish structured recipe data and isn't a recognized video platform.

In these cases, Recipe Box shows a notice and no note is created. You can copy the recipe text and use From Text instead.

From Text

Paste any recipe text - copied from a website, a social media caption, OCR'd from a photo, or whatever format it's in. An optional Title field lets you set the title directly; if left blank, Recipe Box tries to detect it from the text.

Recipe Box looks for "Ingredients" and "Instructions"/"Directions"/"Method"/"Steps" headings (or similar) to split the text into sections, and detects servings, prep/cook/total time, and nutrition from common phrases.

The Review Step

Before anything is saved, Recipe Box shows an editable review form with the parsed data:

Title, Servings, and Time (prep/cook/total, in minutes)
Description
Ingredients and Instructions as plain text - one item per line, with ## Heading lines to start a new group
Nutrition (calories, protein, fat, carbs)

Edit anything before saving. The ## Heading convention works the same whether the recipe came from a URL or pasted text.

Settings

Configured under Settings → Recipe Box → Recipe import:

Setting	Default	What it does
Import folder	(empty = first recipe folder)	Vault-relative folder where imported recipes are saved.
Import template note	(empty = built-in default)	Vault-relative path to a note used as the template for imported recipes.

Custom Import Templates

By default, Recipe Box generates a note using a built-in template. To customize it, point Import template note at your own template note using these tokens:

Token	Value
`{{title}}`	Recipe title
`{{description}}`	Recipe description
`{{image}}`	Hero image URL
`{{url}}`	Source URL (empty for text imports)
`{{servings}}`	Servings/yield
`{{prepTime}}` / `{{cookTime}}` / `{{totalTime}}`	Times in minutes
`{{calories}}` / `{{protein}}` / `{{fat}}` / `{{carbs}}`	Nutrition values
`{{ingredients}}`	Ingredient list (with group headings)
`{{instructions}}`	Numbered instructions (with group headings)
`{{date}}`	Today's date (YYYY-MM-DD)