Threadwell/meta/conventions.md

title, type, status, draft

title	type	status	draft
Conventions	note	draft	true

Frontmatter

Field	Values	Notes
type	archive | canvas | note	Required
source	twitter | discord | youtube | odysee | article | original | other	Archive + media notes
source_url	URL	This note's post, not always the thread root
author	string	Display name
handle	string	Username without @
post_id	string	Twitter status id (spine root or branch root)
date	YYYY-MM-DD	Original publication date
archived	YYYY-MM-DD	When you captured it
status	draft | review | published	Human workflow
draft	true | false	Quartz omit-from-site flag
tags	list	Ingest: archive, twitter, handle. Topics by hand
description	string	Search / OG preview
aliases	list	Extra names
in_reply_to	string	Foreign parent of a spine, if any
parent_post_id	string	Branch notes only: post this branch replies to

draft: true hides the page from the built site. It does not hide the file from a public GitHub repo. Truly private material goes in private/ (gitignored).

Folders

Path	Published	Role
archive/	yes	Primary sources
archive/threads/<handle>/<YYYY-MM-DD-slug>/	yes	One Twitter thread. index.md is the author's chain
canvases/	yes	.canvas maps
notes/	yes	Authored writing
templates/	no	Templater / core templates
meta/	no	Vault rules, local attachments
assets/	no, gitignored	Working media before upload
secrets/	no, gitignored	Cookies and image-host credentials
scripts/	no	Tracked tooling. Quartz-ignored
private/	no, gitignored	Never publish, never push
site/	no, gitignored	Local Quartz clone (own remotes)
publish/	no	Tracked Quartz overlay

A thread folder holds index.md (spine) and one markdown file per off-spine reply tree. Reading guide: notes/How threads are organized.md.

Images

Always absolute HTTPS URLs on the image host (catbox after upload). Do not commit local binaries for published notes. Working files sit in assets/ (gitignored), not in meta/attachments/ except unrelated Obsidian drops.

![](https://files.catbox.moe/example.png)

Video

YouTube / tweet (Quartz OFM):

![](https://www.youtube.com/watch?v=VIDEO_ID)
![](https://youtu.be/VIDEO_ID)
![](https://x.com/user/status/ID)

Odysee (raw iframe; survives the static build):

<iframe width="560" height="315" src="https://odysee.com/$/embed/SLUG/CLAIM" allowfullscreen></iframe>

Get the embed URL from Odysee share → embed. Do not use the watch URL as the iframe src.