[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"nav-notes-count":3,"content-note-do-you-need-a-database-for-your-blog":4},9,{"id":5,"title":6,"author":7,"authorAvatar":8,"authorRole":9,"body":10,"category":551,"date":552,"description":127,"excerpt":553,"extension":554,"image":555,"index":556,"meta":557,"navigation":155,"path":571,"pullQuote":572,"readingTime":573,"seo":574,"slug":575,"stem":576,"takeaways":577,"total":581,"__hash__":582},"notes\u002Fnotes\u002Fdo-you-need-a-database-for-your-blog.md","Do You Need a Database for Your Blog?","Norbert Brett","\u002Fimages\u002Fnorbert-brett.jpg","Full-Stack & AI Systems Engineer",{"type":11,"value":12,"toc":547},"minimark",[13,18,22,30,107,114,121,375,382,386,392,517,523,543],[14,15,17],"h2",{"id":16},"why-git-backed-markdown-fits-technical-studios-and-small-businesses","Why Git-Backed Markdown Fits Technical Studios and Small Businesses",[19,20,21],"p",{},"If you have ever returned to a company blog or portfolio after six months only to find that the cloud database paused itself due to inactivity, a plugin update broke the login screen, or a hosted CMS doubled its monthly subscription fee, you have paid the hidden tax of running a live database for static articles. Years ago, I was annoyed when a five-article engineering blog I maintained went offline on a Sunday morning simply because a managed database rotated its connection credentials during a maintenance window.",[19,23,24,25,29],{},"When I built the ",[26,27,28],"strong",{},"Studio Notes"," publishing system for this Nuxt 4 portfolio, I wanted both engineering reliability and easy browser editing—without running a separate database server.",[31,32,33,38],"blockquote",{},[19,34,35],{},[26,36,37],{},"In Plain English — What Are Markdown, Frontmatter, and Git-Backed Content?",[39,40,41,61,82],"ul",{},[42,43,44,52,53,56,57,60],"li",{},[26,45,46,47,51],{},"Markdown (",[48,49,50],"code",{},".md",")",": Clean, human-readable text files where ",[48,54,55],{},"#"," makes a heading and ",[48,58,59],{},"**bold**"," makes bold text. Even 20 years from now, any text editor on any computer can open a Markdown file—zero vendor lock-in.",[42,62,63,66,67,70,71,70,74,77,78,81],{},[26,64,65],{},"Frontmatter",": A neat block of key-value labels at the very top of an article file (like ",[48,68,69],{},"title",", ",[48,72,73],{},"date",[48,75,76],{},"category",", and ",[48,79,80],{},"image",") that tells the website how to organize and display the card.",[42,83,84,94,95,98,99,102,103,106],{},[26,85,86,87,90,91,51],{},"Git-Backed CMS (",[48,88,89],{},"@nuxt\u002Fcontent"," + ",[48,92,93],{},"nuxt-studio",": Instead of storing articles in a separate database server that can crash or get hacked, your articles live right inside the website's version-controlled folder (",[48,96,97],{},"content\u002Fnotes\u002F*.md","). With ",[26,100,101],{},"Nuxt Studio"," mounted at ",[48,104,105],{},"\u002F_studio",", non-technical editors can still log in through their browser, edit text and images visually, and click \"Publish\" to save changes cleanly to GitHub.",[19,108,109],{},[110,111],"img",{"alt":112,"src":113},"Git-Backed Markdown vs Relational Database Architecture","\u002Fimages\u002Fnotes\u002Fdiagrams\u002Fdo-you-need-a-database-for-your-blog.svg",[19,115,116,117,120],{},"Here is the actual schema contract in ",[48,118,119],{},"content.config.ts"," that powers the feed you are reading right now:",[122,123,128],"pre",{"className":124,"code":125,"language":126,"meta":127,"style":127},"language-ts shiki shiki-themes github-light github-dark","import { defineContentConfig, defineCollection, z } from '@nuxt\u002Fcontent'\n\nexport default defineContentConfig({\n  collections: {\n    notes: defineCollection({\n      type: 'page',\n      source: 'notes\u002F*.md',\n      schema: z.object({\n        index: z.string(),\n        slug: z.string().optional(),\n        title: z.string(),\n        category: z.enum([\n          'Visual Philosophy',\n          'Engineering Craft',\n          'Motion Architecture',\n          'Design Systems',\n        ]),\n        date: z.string(),\n        readingTime: z.string(),\n        image: z.string(),\n        excerpt: z.string(),\n      }),\n    }),\n  },\n})\n","ts","",[48,129,130,150,157,173,179,190,202,213,224,235,251,261,273,281,289,297,305,311,321,331,341,351,357,363,369],{"__ignoreMap":127},[131,132,135,139,143,146],"span",{"class":133,"line":134},"line",1,[131,136,138],{"class":137},"szBVR","import",[131,140,142],{"class":141},"sVt8B"," { defineContentConfig, defineCollection, z } ",[131,144,145],{"class":137},"from",[131,147,149],{"class":148},"sZZnC"," '@nuxt\u002Fcontent'\n",[131,151,153],{"class":133,"line":152},2,[131,154,156],{"emptyLinePlaceholder":155},true,"\n",[131,158,160,163,166,170],{"class":133,"line":159},3,[131,161,162],{"class":137},"export",[131,164,165],{"class":137}," default",[131,167,169],{"class":168},"sScJk"," defineContentConfig",[131,171,172],{"class":141},"({\n",[131,174,176],{"class":133,"line":175},4,[131,177,178],{"class":141},"  collections: {\n",[131,180,182,185,188],{"class":133,"line":181},5,[131,183,184],{"class":141},"    notes: ",[131,186,187],{"class":168},"defineCollection",[131,189,172],{"class":141},[131,191,193,196,199],{"class":133,"line":192},6,[131,194,195],{"class":141},"      type: ",[131,197,198],{"class":148},"'page'",[131,200,201],{"class":141},",\n",[131,203,205,208,211],{"class":133,"line":204},7,[131,206,207],{"class":141},"      source: ",[131,209,210],{"class":148},"'notes\u002F*.md'",[131,212,201],{"class":141},[131,214,216,219,222],{"class":133,"line":215},8,[131,217,218],{"class":141},"      schema: z.",[131,220,221],{"class":168},"object",[131,223,172],{"class":141},[131,225,226,229,232],{"class":133,"line":3},[131,227,228],{"class":141},"        index: z.",[131,230,231],{"class":168},"string",[131,233,234],{"class":141},"(),\n",[131,236,238,241,243,246,249],{"class":133,"line":237},10,[131,239,240],{"class":141},"        slug: z.",[131,242,231],{"class":168},[131,244,245],{"class":141},"().",[131,247,248],{"class":168},"optional",[131,250,234],{"class":141},[131,252,254,257,259],{"class":133,"line":253},11,[131,255,256],{"class":141},"        title: z.",[131,258,231],{"class":168},[131,260,234],{"class":141},[131,262,264,267,270],{"class":133,"line":263},12,[131,265,266],{"class":141},"        category: z.",[131,268,269],{"class":168},"enum",[131,271,272],{"class":141},"([\n",[131,274,276,279],{"class":133,"line":275},13,[131,277,278],{"class":148},"          'Visual Philosophy'",[131,280,201],{"class":141},[131,282,284,287],{"class":133,"line":283},14,[131,285,286],{"class":148},"          'Engineering Craft'",[131,288,201],{"class":141},[131,290,292,295],{"class":133,"line":291},15,[131,293,294],{"class":148},"          'Motion Architecture'",[131,296,201],{"class":141},[131,298,300,303],{"class":133,"line":299},16,[131,301,302],{"class":148},"          'Design Systems'",[131,304,201],{"class":141},[131,306,308],{"class":133,"line":307},17,[131,309,310],{"class":141},"        ]),\n",[131,312,314,317,319],{"class":133,"line":313},18,[131,315,316],{"class":141},"        date: z.",[131,318,231],{"class":168},[131,320,234],{"class":141},[131,322,324,327,329],{"class":133,"line":323},19,[131,325,326],{"class":141},"        readingTime: z.",[131,328,231],{"class":168},[131,330,234],{"class":141},[131,332,334,337,339],{"class":133,"line":333},20,[131,335,336],{"class":141},"        image: z.",[131,338,231],{"class":168},[131,340,234],{"class":141},[131,342,344,347,349],{"class":133,"line":343},21,[131,345,346],{"class":141},"        excerpt: z.",[131,348,231],{"class":168},[131,350,234],{"class":141},[131,352,354],{"class":133,"line":353},22,[131,355,356],{"class":141},"      }),\n",[131,358,360],{"class":133,"line":359},23,[131,361,362],{"class":141},"    }),\n",[131,364,366],{"class":133,"line":365},24,[131,367,368],{"class":141},"  },\n",[131,370,372],{"class":133,"line":371},25,[131,373,374],{"class":141},"})\n",[19,376,377,378,381],{},"Before any update goes live, our automated test suite (",[48,379,380],{},"tests\u002Fportfolio.test.ts",") checks every Markdown file to verify that no title, date, or cover image is missing.",[14,383,385],{"id":384},"markdown-files-vs-hosted-cms-vs-custom-database-how-to-choose","Markdown Files vs. Hosted CMS vs. Custom Database: How to Choose",[19,387,388,389],{},"You see, the right choice depends on one practical question: ",[26,390,391],{},"Does your data change only when an author publishes an article, or does it change every minute while customers interact with the site?",[393,394,395,423],"table",{},[396,397,398],"thead",{},[399,400,401,406,413,416],"tr",{},[402,403,405],"th",{"align":404},"left","What Matters to You",[402,407,408,409,90,411,51],{"align":404},"File-Based Markdown (",[48,410,89],{},[48,412,101],{},[402,414,415],{"align":404},"Hosted Headless CMS (Sanity \u002F Strapi \u002F Contentful)",[402,417,418,419,422],{"align":404},"Custom Database (",[48,420,421],{},"PostgreSQL"," + Admin Portal)",[424,425,426,446,462,486],"tbody",{},[399,427,428,434,440,443],{},[429,430,431],"td",{"align":404},[26,432,433],{},"How You Edit Content",[429,435,436,437,439],{"align":404},"Visual browser editor at ",[48,438,105],{}," OR directly in code; full undo history on every line.",[429,441,442],{"align":404},"Cloud dashboard with user roles; triggers webhooks to update the site.",[429,444,445],{"align":404},"Custom admin forms built specifically for your business workflows.",[399,447,448,453,456,459],{},[429,449,450],{"align":404},[26,451,452],{},"What Can Break at 2 AM?",[429,454,455],{"align":404},"Almost nothing—articles are pre-packaged with the site at build time.",[429,457,458],{"align":404},"Third-party API outages, expired tokens, or rate limits.",[429,460,461],{"align":404},"Database connection limits, server updates, and backup maintenance.",[399,463,464,469,476,479],{},[429,465,466],{"align":404},[26,467,468],{},"Quality Protection",[429,470,471,472,475],{"align":404},"Broken fields or missing images are blocked automatically by ",[48,473,474],{},"pnpm test"," before launch.",[429,477,478],{"align":404},"Editors can accidentally publish incomplete fields unless custom webhooks check them.",[429,480,481,482,485],{"align":404},"Protected by database constraints and server-side ",[48,483,484],{},"Zod"," validation.",[399,487,488,493,501,509],{},[429,489,490],{"align":404},[26,491,492],{},"Monthly Running Cost",[429,494,495,500],{"align":404},[26,496,497],{},[48,498,499],{},"$0 \u002F month"," (included in standard web hosting).",[429,502,503,508],{"align":404},[26,504,505],{},[48,506,507],{},"$0–$99+ \u002F month"," once you add team seats or traffic.",[429,510,511,516],{"align":404},[26,512,513],{},[48,514,515],{},"$15–$60+ \u002F month"," for managed database hosting and backups.",[19,518,519,520,522],{},"I felt relieved once this site's entire blog was consolidated into ",[48,521,97],{},": pages load instantaneously, backups are automatic in Git, and there is zero database maintenance overhead.",[39,524,525,535],{},[42,526,527,534],{},[26,528,529,530,90,532,51],{},"Choose File-Based Markdown (",[48,531,89],{},[48,533,93],{}," for company blogs, case studies, documentation, and service pages (5 to 500 articles) where speed, zero monthly fees, and simplicity win.",[42,536,537,542],{},[26,538,539,540,51],{},"Choose a Relational Database (",[48,541,421],{}," when customers create records live on the site (appointment bookings, user accounts, order history, or 10,000+ searchable product SKUs).",[544,545,546],"style",{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":127,"searchDepth":152,"depth":152,"links":548},[549,550],{"id":16,"depth":152,"text":17},{"id":384,"depth":152,"text":385},"Engineering Craft","October 24, 2026",null,"md","\u002Fimages\u002Fnotes\u002Fdo-you-need-a-database-for-your-blog.webp","06",{"sections":558},[559,565],{"marker":560,"heading":561,"body":562},"\u002F A","Why Git-Backed Markdown Fits Technical Studios",[563,564],"When I upgraded this portfolio to Nuxt 4, I evaluated whether to back Studio Notes with a Postgres table, a hosted headless CMS, or file-based Markdown via @nuxt\u002Fcontent v3 and nuxt-studio.","Storing articles in content\u002Fnotes\u002F*.md validated by a Zod schema in content.config.ts means every post is versioned in Git, tested in CI by Vitest, and deployed atomically with the site.",{"marker":566,"heading":567,"body":568},"\u002F B","When to Stay File-Based and When to Reach for Postgres",[569,570],"Adding nuxt-studio at \u002F_studio solves the non-technical editing gap: you or a client can edit Markdown and frontmatter visually in the browser and commit straight back to GitHub without touching a terminal.","A database only earns its keep when your content changes independent of deploys—such as multi-tenant user submissions, live inventory, or 50,000 dynamic catalog records.","\u002Fnotes\u002Fdo-you-need-a-database-for-your-blog","Running a managed Postgres instance and an auth server just to publish ten technical essays a year is operational cosplay.","6 min read",{"title":6,"description":127},"do-you-need-a-database-for-your-blog","notes\u002Fdo-you-need-a-database-for-your-blog",[578,579,580],"For a portfolio or company blog (5–500 posts), file-based Markdown (@nuxt\u002Fcontent + Nuxt Studio) means $0 database bills and zero server outages.","Non-technical editors still get a visual browser interface at \u002F_studio that saves changes directly to GitHub.","Reserve a live database (PostgreSQL) for data that changes while users are on the site: bookings, customer accounts, or 10,000+ catalog items.","10","N2zInUfXWcY5ECYH-mE4N2Qm3VQF9lZtwwiuPcAfenQ"]