Core Concepts

Focus

Understanding focus is essential to understanding how Arky operates. This section explores the basic concept and use cases of focus.

  • You can focus on a specific Shell to work exclusively within its content.
  • Entering a Shell opens a new canvas dedicated to that Shell's contents, where you can view and edit them.
  • Content created inside is organized in order when returning to the parent level.

How to Focus

On the canvas, hold (or Ctrl for Windows users) and click a Shell to focus on it. You can also focus on a Shell by clicking it from the Outline tab in the left sidebar.

Nested Canvas

A specific Shell at any level can be focused, opening a new canvas based on that Shell.

When you first create a Project, it's considered the Root Shell — and by default, you're focused on that Root Shell.

  • Creating a Shell is like creating a dedicated entry point — a space where you can create and view only its internal contents.
  • When you focus into a Shell, it opens as a new canvas. Any content you create inside is automatically organized in the order you created it.
  • When you return to the parent level, the content inside that Shell remains arranged in order.

💡 Shell depth cannot exceed heading level 6 in Markdown. This means, if you focus into a Shell at depth 6, you cannot create new Shells inside it. This hierarchical constraint exists because Arky's structure maps one-to-one with Markdown.

Outline tab

The left sidebar has two tabs: Outline and Details. Let's start with Outline.

  • The Outline tab displays the shell hierarchies within this project.
  • The order reflects how they're arranged in Document view, and deeper indentation indicates deeper hierarchy levels.
  • You can drag and drop to reorder items in Document view or restructure the hierarchy.

When you click on a specific shell in the Outline tab, it focuses into that shell.

  • To work exclusively with the contents of a specific shell, simply click it in the Outline.
  • To return to the top level, click the project name at the top of the Outline tab, or use the navigation path in the top-left corner.

Details tab

The Details tab shows the contents inside the currently focused Shell. Clicking any block or Shell navigates you to its location on the canvas.