The Phase 1 format guide

What your notebook
can carry.

Mementara reads Markdown notebooks stored in GitHub. Here’s what works in the first implementation, and where a file needs a little preparation.

Everyday notes, with their connections.

Markdown headings, tables, display-only task lists, strikethrough, fenced code, and plain UTF-8 text are supported. Math uses bundled KaTeX. Titles, aliases, and tags have a supported frontmatter subset.

Follow relative links, wikilinks, headings, and block anchors. Supported note, heading, and paragraph or list-block embeds can appear inside a note. Ambiguous names ask you to choose a destination; missing or unsupported content shows a fallback. Paths are case-sensitive.

Diagrams and attachments.

• Mermaid: supported diagrams render locally. Flowchart, sequence, class, state, entity-relationship, and Gantt examples are included in the sample. Unsupported or invalid syntax falls back to source.
• Images: cached PNG, JPEG, WebP, GIF, and a sanitized SVG subset. Animation is not certified in every native view.
• PDFs: downloaded documents open in the native PDF viewer. You can find a PDF by filename; full-text and OCR search are outside this version.
• PlantUML, draw.io, and Excalidraw: bring an exported preview alongside the source, such as architecture.puml.svg beside architecture.puml. The full source filename must match. Mementara displays the export; it does not execute those diagram tools or verify that an export is current.

What “offline” means.

Once notes are ready, the selected notebook’s supported text and local search index are available offline. Media is ready when eligible local images, exported previews, and PDFs have also downloaded. The app reports incomplete coverage separately.

External links, remote resources, and uncached or oversized files are outside offline coverage. Remote images never load automatically. Git LFS files, symlinks, and submodules are recognized but not downloaded or followed.

Search the words you remember.

Search matches words and prefixes in note text, headings, supported titles, aliases, and tags, returning section excerpts and links to their source. It is local text search. It does not generate answers, understand diagram structure, or search text inside images and PDFs. Some languages, including contiguous CJK text, have token-matching limitations.

A reading companion for your existing setup.

No Obsidian installation or .obsidian folder is required. Obsidian plugins, Dataview queries, scripts, arbitrary HTML execution, and interactive Canvas are unsupported. Audio and video depend on an explicit handoff to available platform viewers.

The first version connects one GitHub.com account and one active repository, branch, and optional root folder. You can replace that connection to switch notebooks. Multiple active notebooks, GitHub Enterprise Server, other Git hosts, Android, editing, and AI are outside Phase 1.

Start with a manageable notebook.

Current limits are 2,000 notes, 1 MiB per note, 100 MiB of text, 20 MiB per attachment, and 500 MiB of referenced media. Choose a smaller root folder for a large repository. Limits describe the current implementation, not a performance guarantee on every supported device.

Explore the sample notebook ↗

Updated 6 September 2026 · Requires iOS 18 or later.