Tela — Team Onboarding
layout: cover kicker: Team onboarding title: Welcome to tela subtitle: A markdown-native team wiki — docs, decks, knowledge base, and agents.
layout: define kicker: The basics term: What is tela? definition: A markdown-native team wiki where people and agents write together. points:
- Every page is plain markdown — no lock-in
- Block editor, live collaboration, full-text + semantic search
- A built-in MCP server makes agents first-class readers and writers
layout: bigtype kicker: Meta title: This presentation is a tela page. subtitle: Markdown in, slides out.
layout: agenda kicker: The tour title: What we'll cover items:
- { topic: Foundations, desc: "spaces, pages, the markdown promise" }
- { topic: Writing, desc: "the block editor, sheets & decks" }
- { topic: Knowledge base, desc: "links, graph, search & ask" }
- { topic: Trust, desc: "provenance & conflict signals" }
- { topic: Agents & MCP, desc: "connect Claude, Cursor, ChatGPT" }
- { topic: Sync & publish, desc: "your vault, public URLs" }
- { topic: Administration, desc: "people, access, SSO" }
layout: section index: "01" kicker: Part one title: Foundations subtitle: How tela is put together
layout: panels kicker: The vocabulary title: Core concepts panels:
- { icon: "lucide:folders", title: Spaces, items: ["A tree of pages", "Own members & visibility", "Private or public"] }
- { icon: "lucide:file-text", title: Pages, items: ["Markdown documents", "Link with [[wikilinks]]", "Backlinks build themselves"] }
- { icon: "lucide:users", title: Organizations, items: ["Group people", "Grant a team at once", "Domain auto-join + SSO"] }
- { icon: "lucide:share-2", title: Sharing, items: ["Public link per page", "Or publish a whole space", "Read-only to the world"] }
layout: statement kicker: Under the hood title: Every page is plain markdown.
layout: section index: "02" kicker: Part two title: Writing subtitle: Documents, sheets and decks, from plain markdown
layout: feature kicker: Type "/" for the block menu title: The block palette columns: 3 features:
- { icon: "lucide:message-square-warning", title: Callouts, desc: "note · tip · warning asides" }
- { icon: "lucide:table", title: Tables, desc: "sortable, with icon cells" }
- { icon: "lucide:square-kanban", title: Kanban, desc: "draggable card boards" }
- { icon: "lucide:bar-chart-3", title: Charts, desc: "bar · line · pie, themed" }
- { icon: "lucide:workflow", title: Mermaid, desc: "flow, sequence, ER diagrams" }
- { icon: "lucide:pen-tool", title: Drawings, desc: "hand-drawn, multiplayer" }
- { icon: "lucide:panels-top-left", title: Tabs & folds, desc: "tuck away the detail" }
- { icon: "lucide:sigma", title: Math, desc: "LaTeX equations & inline" }
- { icon: "lucide:paperclip", title: Files & images, desc: "drag, drop, preview inline" }
layout: two-cols kicker: Little things that add up title: The editor, day to day
Type / for the block menu — start typing to filter: /call, /mermaid, /table.
/ insert · ⌘K search · ? shortcuts
Drawings and editing are multiplayer — strokes and cursors sync live.
::right::
Smart tables — check / cross cells become colored icons; long tables get sort + filter. handy
Live sheets — turn a page into a spreadsheet: GFM tables + formulas that compute, totals and styling.
Read mode — table of contents and progress bar. Add ?view=read to any page.
Auto-summaries — every page gets a 1–2 sentence summary, refreshed as it changes.
layout: columns kicker: Decks title: Write, style, present columns:
- { title: "1 · Write", items: ["Plain markdown", "A divider starts each slide", "Pick a layout, fill fields"] }
- { title: "2 · Style", items: ["13 built-in variants", "Switch in the theme picker", "No CSS"] }
- { title: "3 · Present", items: ["Live, in a new tab", "Notes, overview, drawing", "Export to PDF / PPTX"] }
layout: two-cols kicker: Presenting title: Live, in the browser
- ← / → or space to navigate, F for fullscreen
- O — slide overview grid; jump anywhere
- Presenter view — notes + next-slide preview + clock
- Draw on slides live; click-through builds animate
::right::
Don't want to lay it out yourself? Ask an agent — "make me a deck about X" — and it writes a styled tela deck.
layout: section index: "03" kicker: Part three title: Knowledge base subtitle: Links, graph, and search
layout: two-cols kicker: Connections build themselves title: Link once, navigate forever
Type [[ and pick a page. tela records a backlink, so every page's "what links here" is automatic.
A new draft can get suggested links to wire it in.
::right::
Graph view turns a space into a map — pages are nodes, links are edges. Spot clusters, hubs, and orphans.
layout: columns kicker: Three ways to find anything title: From keywords to questions columns:
- { title: Full-text, items: ["Ranked Postgres search", "Title-weighted, highlighted", "Fast and exact"] }
- { title: Semantic, items: ["Finds by meaning", "Spans pages and files", "Even inside PDFs"] }
- { title: Ask your docs, items: ["Natural-language Q&A", "Cited, streamed answers", "Says when it doesn't know"] }
layout: default kicker: Ask your docs title: Grounded answers, with citations
- Retrieves only the spaces you can read — never across access
- Answers from your pages, cites the sources, and streams as it writes
- Marks an answer low-confidence when the grounding is thin
When sources disagree it shows both sides — "source A says X, but source B says Y — verify."
layout: feature kicker: The same index keeps you tidy title: Hygiene, automated columns: 2 features:
- { icon: "lucide:git-compare", title: Related pages, desc: "a semantic 'see also' on every page" }
- { icon: "lucide:link-2", title: Link suggestions, desc: "wire a new draft into the wiki" }
- { icon: "lucide:copy", title: Overlap detection, desc: "find near-duplicates to merge" }
- { icon: "lucide:list-todo", title: Knowledge gaps, desc: "questions your docs couldn't answer" }
layout: section index: "04" kicker: Part four title: Trust & provenance subtitle: How much to trust a page
layout: feature kicker: A quiet strip under every title title: Four trust signals, computed for you columns: 2 features:
- { icon: "lucide:clock", title: Freshness, desc: "warns when a page goes stale" }
- { icon: "lucide:user-check", title: Provenance, desc: "human · agent · synced" }
- { icon: "lucide:check-check", title: Corroboration, desc: "other pages that agree" }
- { icon: "lucide:triangle-alert", title: Dispute, desc: "pages that contradict — click to see" }
layout: section index: "05" kicker: Part five title: Agents & MCP subtitle: Connect any MCP client
layout: steps kicker: Connecting a client title: Sign in once — nothing to paste steps:
- { title: Point at your tela, desc: "add https:///api/mcp in Claude, ChatGPT or Cursor", icon: "lucide:plug" }
- { title: Sign in through tela, desc: "OAuth sends you to tela and back — no token to copy", icon: "lucide:log-in" }
- { title: Search, read and write, desc: "every tool runs with your own permissions", icon: "lucide:bot" }
layout: two-cols kicker: OAuth by default title: Connect from anywhere
On claude.ai, ChatGPT and Cursor, add the URL and sign in through tela — nothing to paste. Claude Code inherits the connectors you added on claude.ai.
HTTP — https://<host>/api/mcp. The default for every modern client.
Token — self-hosted or a stdio-only host? Mint a PAT (read / write / admin) and pass it as a bearer, or run npx tela-mcp.
::right::
Step-by-step for every client — claude.ai, Claude Code, ChatGPT, Cursor, tokens & troubleshooting: telawiki.com/tela/docs
layout: columns kicker: Every tool runs as you title: What an agent can do columns:
- { title: Read & find, items: ["search · research", "get_page · read_chunk", "list_backlinks"] }
- { title: Write, items: ["create · update · patch", "move · delete · comment", "attach files & images"] }
- { title: Beyond, items: ["build decks & live sheets", "share_page → public link", "run Atlas on a repo"] }
layout: default kicker: Atlas — automated documentation title: Point it at a repo. Get a documented wiki.
- Aim Atlas at a git repository or Jira project — it reads the whole thing
- Out comes a folder of grounded pages — overview, architecture, modules
- Every significant claim cites its source: a commit-pinned line range, or a Jira issue
- Coverage-audited, and pages re-generate as the code and tickets move
Just ask your agent — "run Atlas on this repo" — or trigger it from the space. Details in the docs.
layout: section index: "06" kicker: Part six title: Sync & publish subtitle: Local files, and the public web
layout: two-cols kicker: Edit in any app · back it up title: Mount tela as local files
Every space is a WebDAV tree. Mount it on macOS, Windows, Linux, iOS, Android — pages are .md, child pages are folders. The password is a token.
For two-way sync, Settings → Sync → Connect a vault hands you a ready rclone setup.
::right::
Rename a file → retitles the page. Move it → reparents. Identity rides in frontmatter, so no duplicates.
layout: columns kicker: Owner flips one switch title: A space becomes a site columns:
- { title: Publish, items: ["Private → Public", "Whole space, read-only", "These docs are one"] }
- { title: Structure, items: ["Top pages are posts", "A page with children is a section", "Decks show as cards"] }
- { title: URLs, items: ["/{handle} home", "/{handle}/{space}", "/discover directory"] }
layout: section index: "07" kicker: Part seven title: Administration subtitle: People and access
layout: panels kicker: For admins title: People, access, accountability panels:
- { icon: "lucide:user-cog", title: Users, items: ["Email-first sign-up", "Plans & usage at a glance", "Activity per account"] }
- { icon: "lucide:building-2", title: Organizations, items: ["Group & grant at once", "Domain auto-join", "Members, admins, groups"] }
- { icon: "lucide:fingerprint", title: SSO & login, items: ["OIDC: Entra, Okta, Google", "Optional enforcement", "Social login buttons"] }
- { icon: "lucide:scroll-text", title: Audit & events, items: ["Sign-ins, views, edits", "Access-change audit log", "A searchable firehose"] }
layout: reference kicker: Token scopes title: Permissions, in three words items:
- { term: read, desc: "browse, download, search — a safe backup or Q&A agent" }
- { term: write, desc: "+ create, edit, move, delete, comment, import" }
- { term: admin, desc: "full administrative access — only when you need it" }
layout: steps kicker: Getting started title: Your first fifteen minutes steps:
- { title: Make a space, desc: "for your team or org; invite members", icon: "lucide:folder-plus" }
- { title: Write a page, desc: "type /, link with [[…]]", icon: "lucide:pencil" }
- { title: Connect your agent, desc: "point it at /api/mcp and sign in — no token to paste", icon: "lucide:plug" }
- { title: Ask your docs, desc: "search, then ask a real question", icon: "lucide:sparkles" }