Parchment

Cos'è Parchment?

Parchment è un semplice SaaS “alternativa a Notion” progettato per creare e organizzare pagine e raccolte standalone. Offre un'interfaccia pulita incentrata concettualmente sull'organizzazione del contenuto in pagine, con le raccolte che fungono da raggruppamenti.

Una parte fondamentale della funzionalità di Parchment è l'accesso programmatico: puoi gestire raccolte, pagine e i blocchi all'interno delle pagine tramite un'API. Questo è pensato per utenti che desiderano contenuti di pagina strutturati che possano creare, aggiornare ed esportare tramite codice.

Funzionalità Principali

• Raccolte e pagine (gestite tramite azioni API): Crea, rinomina, elenca ed elimina raccolte e pagine per controllare programmaticamente la struttura del contenuto.
• Contenuto di pagina basato su blocchi: Le pagine sono composte da blocchi ordinati (es. titoli, testo, elenchi, codice, divisori) che puoi aggiungere o sostituire.
• Sostituzione completa della pagina con replace_blocks: Replace elimina tutti i blocchi esistenti sulla pagina e scrive un nuovo array in ordine—utile per generare una pagina completa da zero.
• Modifiche incrementali con append_blocks: Append aggiunge blocchi alla fine di una pagina senza sostituire il contenuto esistente, supportando flussi di lavoro additivi.
• Elenchi nidificati con indent_level: I blocchi bullet_list e numbered_list accettano un intero indent_level (0–4) per rappresentare il rendering di elenchi nidificati.
• Formattazione dei blocchi basata su HTML: Il contenuto dei blocchi è memorizzato come stringhe HTML; la formattazione supportata include grassetto, corsivo, barrato, link e testo colorato tramite tag HTML standard.
• Blocchi di gruppo (group / delete_group): Un blocco group funge da contenitore per blocchi figli; crei il group, associ poi i blocchi figli con group_id e puoi eliminare il group (e i figli) in un'unica operazione.
• Tipi di blocchi definiti: Include text, heading1/2/3, bullet_list, numbered_list, todo, quote, divider, code e group.

Come Usare Parchment

1. Crea una chiave API e invia richieste all'URL base dell'API: https://theparchment.app/functions/v1/api.
2. Elenca o crea struttura: Inizia elencando le raccolte (list_collections), poi crea raccolte e pagine usando le azioni corrispondenti (es. create_collection, create_page).
3. Scrivi contenuto di pagina usando blocchi: Usa append_blocks per aggiungere blocchi alla fine di una pagina esistente, o replace_blocks per riscrivere l'intera pagina in una sola chiamata.
4. Formatta il contenuto con stringhe HTML: Fornisci il content di ogni blocco come stringa HTML usando i tag supportati (ad esempio, link tramite <a href="...">...</a>).
5. Organizza con raggruppamento quando necessario: Crea prima un blocco group, poi aggiungi blocchi figli che fanno riferimento al group tramite group_id; rimuovi contenuti correlati usando delete_group.

Casi d'Uso

• Genera pagine da dati strutturati: Usa replace_blocks per scrivere un layout di pagina completo (titoli, divisori, paragrafi, elenchi) da una singola fonte di verità.
• Costruisci log di documentazione “append-only”: Usa append_blocks per aggiungere nuove sezioni, aggiornamenti o voci alla fine di una pagina senza disturbare il contenuto precedente.
• Mantieni checklist gerarchiche: Crea blocchi todo (elementi con casella di spunta) e usa blocchi bullet_list/numbered_list nidificati con indent_level per rappresentare sottotask o outline.
• Gestisci blocchi di contenuto templatizzati su più pagine: Crea e rinomina pagine programmaticamente, poi inserisci sequenze di blocchi consistenti (inclusi snippet di codice tramite il tipo code).
• Crea sezioni riutilizzabili tramite raggruppamento: Usa blocchi group per mantenere blocchi correlati insieme, ed elimina o rigenera un'intera sezione usando delete_group.

FAQ

• Quale endpoint usa l'API di Parchment? L'URL base dell'API è https://theparchment.app/functions/v1/api.

• Come autentico le richieste? Tutte le richieste richiedono un header x-api-key. Gli esempi nella documentazione mostrano x-api-key: pmt_your_key.

• Qual è la differenza tra append_blocks e replace_blocks? append_blocks aggiunge nuovi blocchi alla fine della pagina senza sostituire i blocchi esistenti, mentre replace_blocks elimina tutti i blocchi esistenti e scrive i blocchi forniti in ordine di array.

• I contenuti dei blocchi sono testo semplice o HTML? Il contenuto dei blocchi è memorizzato come stringhe HTML; la formattazione usa tag HTML standard (es. <strong>, <i>, <a> e <span style="color: ...">).

• Come funzionano gli elenchi nidificati? Per bullet_list e numbered_list, i blocchi supportano un campo indent_level (intero 0–4) per rappresentare sottoliste nidificate.

Alternative

• Altri strumenti di documentazione o knowledge-base con API: Se devi generare o aggiornare pagine strutturate tramite codice, cerca tool che offrano API per blocchi/pagine simili al modello raccolta/pagina/blocco.
• Piattaforme wiki/documentation generiche: Possono supportare gerarchie di pagine e templating, ma il flusso di lavoro e il modello dati potrebbero differire (soprattutto se non usano array di blocchi).
• Approcci generici database-to-pages: Tool che rendono contenuto da un database in pagine potrebbero adattarsi quando il tuo obiettivo principale è l'organizzazione strutturata, anche se potrebbero non fornire le stesse semantiche di append/sostituzione a livello di blocco.
• Generatori di siti statici locali: Per team a proprio agio con la generazione al momento del build, tool statici possono produrre pagine consistenti da template, ma tipicamente non supportano lo stesso modello di editing interattivo di pagine tramite API SaaS.