[{"data":1,"prerenderedAt":296},["ShallowReactive",2],{"/api/concepts/markdown":3,"/api/concepts/markdown-surround":289},{"id":4,"title":5,"body":6,"description":280,"extension":281,"links":282,"meta":283,"navigation":284,"path":285,"seo":286,"stem":287,"__hash__":288},"docs/api/2.concepts/markdown.md","Markdown",{"type":7,"value":8,"toc":272},"minimark",[9,28,39,44,136,139,143,146,182,192,196,259,265],[10,11,12,13,16,17,22,23,27],"p",{},"Much of the Capacities API is also available through ",[14,15,5],"strong",{},". You send or receive a string of Markdown instead of building ",[18,19,21],"a",{"href":20},"/api/concepts/blocks","blocks"," and ",[18,24,26],{"href":25},"/api/concepts/text-tokens","text tokens"," by hand.",[10,29,30,31,34,35,38],{},"Markdown is a ",[14,32,33],{},"compressed, reduced representation"," of page content. It does not cover every layout and property the full API can express, but it matches how many tools and models already think about text — which makes it especially useful for ",[14,36,37],{},"AI assistants",", scripts, and quick integrations.",[40,41,43],"h2",{"id":42},"what-markdown-can-do","What Markdown can do",[45,46,47,63],"table",{},[48,49,50],"thead",{},[51,52,53,57,60],"tr",{},[54,55,56],"th",{},"Area",[54,58,59],{},"Endpoint",[54,61,62],{},"Direction",[64,65,66,81,93,105,118],"tbody",{},[51,67,68,72,78],{},[69,70,71],"td",{},"Object body",[69,73,74],{},[75,76,77],"code",{},"GET /object/markdown",[69,79,80],{},"Read — export an object as Markdown",[51,82,83,85,90],{},[69,84,71],{},[69,86,87],{},[75,88,89],{},"POST /object/markdown",[69,91,92],{},"Write — create an object from Markdown",[51,94,95,97,102],{},[69,96,71],{},[69,98,99],{},[75,100,101],{},"POST /blocks/markdown/append",[69,103,104],{},"Write — append Markdown to an existing object",[51,106,107,110,115],{},[69,108,109],{},"Daily notes",[69,111,112],{},[75,113,114],{},"POST /blocks/markdown/daily-note",[69,116,117],{},"Write — append to a daily note",[51,119,120,123,133],{},[69,121,122],{},"Weblink notes",[69,124,125,128,129,132],{},[75,126,127],{},"POST /object/url"," (optional ",[75,130,131],{},"markdown"," field)",[69,134,135],{},"Write — notes on a new link object",[10,137,138],{},"Conversion follows the same rules as Markdown in the Capacities app (headings, lists, links, tags where supported). Markdown is converted to blocks when writing, and blocks to Markdown when exporting.",[40,140,142],{"id":141},"what-markdown-does-not-replace","What Markdown does not replace",[10,144,145],{},"These still use the full JSON models:",[147,148,149,167,176],"ul",{},[150,151,152,155,156,162,163,166],"li",{},[14,153,154],{},"Properties"," — title, tags, dates, relations, and other fields on ",[18,157,159],{"href":158},"/api/reference",[75,160,161],{},"PATCH /object"," (see ",[18,164,154],{"href":165},"/api/concepts/properties",")",[150,168,169,172,173,166],{},[14,170,171],{},"Precise block edits"," — updating one block by id, grid layouts, or exact token styling (",[18,174,175],{"href":20},"Blocks",[150,177,178,181],{},[14,179,180],{},"Collections, delete, and metadata"," — unchanged; combine Markdown routes with normal object endpoints as needed",[10,183,184,185,188,189,191],{},"Typical pattern: create or update properties with ",[75,186,187],{},"POST /object"," or ",[75,190,161],{},", and use Markdown only for the main body content.",[40,193,195],{"id":194},"markdown-vs-blocks","Markdown vs blocks",[45,197,198,209],{},[48,199,200],{},[51,201,202,204,206],{},[54,203],{},[54,205,5],{},[54,207,208],{},"Blocks + text tokens",[64,210,211,226,237,248],{},[51,212,213,216,223],{},[69,214,215],{},"Best for",[69,217,218,219,222],{},"LLM output, ",[75,220,221],{},".md"," files, quick capture",[69,224,225],{},"Exact structure, embeds, fine-grained edits",[51,227,228,231,234],{},[69,229,230],{},"Payload size",[69,232,233],{},"Small string",[69,235,236],{},"Larger JSON trees",[51,238,239,242,245],{},[69,240,241],{},"Expressiveness",[69,243,244],{},"Subset of Capacities formatting",[69,246,247],{},"Full block types and inline tokens",[51,249,250,253,256],{},[69,251,252],{},"Round-trip",[69,254,255],{},"Good for prose; some details may differ",[69,257,258],{},"Lossless for supported block types",[260,261,262],"tip",{},[10,263,264],{},"For AI workflows, prefer Markdown endpoints when the model produces text. Drop to block JSON only when you need a specific block type, layout, or per-block patch.",[10,266,267,268,271],{},"See the ",[18,269,270],{"href":158},"API Reference"," for request bodies and SDK samples on each Markdown route.",{"title":273,"searchDepth":274,"depth":275,"links":276},"",1,2,[277,278,279],{"id":42,"depth":275,"text":43},{"id":141,"depth":275,"text":142},{"id":194,"depth":275,"text":195},"Using Markdown as a compressed alternative to blocks and tokens in the Capacities API.","md",null,{},true,"/api/concepts/markdown",{"title":5,"description":280},"api/2.concepts/markdown","pMcd1vEHa8SOiWgTMDT8v7mM8gBpxOa4xXPLeheMxso",[290,292],{"title":175,"path":20,"stem":291,"children":-1},"api/2.concepts/blocks",{"title":293,"path":294,"stem":295,"children":-1},"Objects","/api/concepts/objects","api/2.concepts/objects",1781012286330]