Skip to main content

Options for Document and Cell

Runme badget

Changing the behavior of executing code and commands in Runme can be done either at the Document level or the Cell level inside the markdown document. This page is a reference for both.

Document Options

Frontmatter in yaml, json, or toml on top of Markdown document.

ConfigurationDescriptionDefault value
cwdOverwrites the default working directory[Markdown file's basedir]
shellOverwrites shell with custom preference[system/user default]
skipPromptsBypasses interactive prompts[system/user default]

Cell Options

Metadata inside Markdown's fenced code blocks.

ConfigurationDescriptionDefault value
backgroundIndicates if the cell should be runned as a background processfalse
closeTerminalOnSuccessHide Terminal after cell successful executiontrue
categoryExecute this code cell within a category[empty]
cwdModify current working directory for cell execution[empty]
excludeFromRunAllPrevent executing this cell during the "Run All" operationfalse
interactiveIndicates if run should allow interactive inputfalse
interpreterThe program or command line inserted into shebang (aka #!) lineinferred from languageId
mimeTypeIf set skips auto-detection and uses specific media (MIME) type[empty]
nameCell’s canonical name useful for referencing the cell via CLIauto-generated
terminalRowsNumber of rows to display in the notebook terminalauto-set
promptEnvPrompt user to set exported environment varsauto
skipPromptsBypasses interactive prompts that require inputting environment vars or authentication confirmations.false

SkipPrompts

This feature can be used to prevent prompting when exporting an environment variable. By configuring the cell options appropriately, you can streamline your workflow and make your environment setup more efficient.