OwnShip Guide

Content Files

OwnShip serves three types of content file.

Markdown — .md

The primary format. Standard Markdown: headings, lists, tables, code blocks, blockquotes, bold, italic, images, links. Hard line breaks with two trailing spaces or explicit <br>.

The file's first # H1 heading becomes its display name in the navigation. If there's no H1, the filename is used (extension stripped, dashes replaced with spaces).

index.md in any folder is treated as that folder's home page and hidden from the navigation tree.

HTML — .html

Rendered inside a sandboxed <iframe> — scripts and all, safely isolated from the rest of the page. Useful for embedding interactive content or demos.

Plain text — .txt

Rendered in a <pre> block, preserving whitespace and formatting.

Hidden files

The following are automatically hidden from navigation:

Directory structure

Subdirectories appear in the navigation tree. Empty directories are hidden. Files and folders are sorted alphabetically and intermixed.