# Jooish

> Jooish is a reader for Jewish community news, WhatsApp group and status feeds, and podcasts. Every public page is also available as clean Markdown for AI agents.

## Reading any page as Markdown

Any public page on https://jooish.app can be retrieved as a Markdown document in either of two ways:

- Send the header `Accept: text/markdown` on the normal URL, or
- Append `.md` to the URL path, before any query string (for example `https://jooish.app/sites/posts/<id>.md`).

Both return the same document. Without either, the URL returns the normal HTML page. Only public content is served as Markdown; private or members-only content returns 404.

## How to navigate

Every Markdown document starts with a YAML frontmatter block, for example:

```
---
type: group_transcript
canonical: https://jooish.app/groups/breaking-news
up: https://jooish.app/groups/discover
next: https://jooish.app/groups/breaking-news?cursor=abc123&direction=older
prev: null
---
```

Follow these links to move around. Each is a full URL, so you never have to build one yourself:

- **canonical**: the stable URL of this document (always without `.md`).
- **up**: the parent or index this document belongs to (a post links up to its feed, an episode to its show, a message to its group directory).
- **next** / **prev**: the next and previous pages of a paginated list.

List documents repeat these as links in the body and link every item to its own document.

Tip: if you fetched the `.md` form, the follow-links keep the `.md` suffix, so you can keep navigating without setting a header.

## Pagination

Two styles appear in `next` and `prev` links. Just follow the URL provided; do not construct the query yourself.

- Offset lists (news feeds, publisher lists, search results): `?skip=N` or `?offset=N`.
- Cursor lists (group transcripts, podcast episodes): `?cursor=<token>&direction=older` for older, `direction=newer` for newer.

## Entry points

- Home index: https://jooish.app/
- News feed: https://jooish.app/sites/feed/news
- Trending news: https://jooish.app/sites/feed/trending
- Publishers, browse: https://jooish.app/sites/discover
- Groups, browse: https://jooish.app/groups/discover
- Podcasts, browse: https://jooish.app/podcasts
- Search everything: https://jooish.app/search?q=YOUR+QUERY
- Full URL list: https://jooish.app/sitemap.xml

## Document types (the `type` field)

- `home`: an index of what is popular now, linking into each section.
- `post`: a single news article with title, publisher, date, body, and the original source link.
- `post_list`: one page of a news feed.
- `site_list`: one page of publishers.
- `groups_discover`: the public groups directory.
- `group_transcript`: a group chat grouped by day; attachments are linked, and video is a link rather than inline media.
- `podcast_browse`, `podcast_show`, `podcast_episode`: the podcast catalog, a show with its episodes, and a single episode with show notes and an audio link.
- `search`: results for a `?q=` query, grouped into sections for posts, sites, groups, and podcasts.

## Notes

- Search: append `?q=<query>` to `/search`. Full-text post search needs at least 3 characters; name searches work from 1.
- Times: all timestamps are ISO 8601 in UTC (for example `2026-09-08T14:30:05Z`), shown wherever the content has a known time (article publish, message send, episode release).
- Media: images render as Markdown images; audio and video render as labeled links, since they cannot be inlined.
- All content here is public. There is no login for the Markdown surface.