docs: emphasize beautiful PDF output in README, SEO, and metadata

mertguvencli · claude · mertguvencli · commit 3482491cb199 · 2026-04-10T20:25:11.000+03:00
Shift messaging from "Markdown editor" to "beautiful PDF output" —
the core value proposition. Update metadata titles, descriptions,
keywords, structured data, FAQ, and SEO footer accordingly.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/README.md b/README.md
@@ -1,6 +1,8 @@
 # MarkBloom
 
-Free, open-source Markdown to PDF converter that runs entirely in your browser. Write Markdown, see a live preview, and export beautifully formatted PDFs — no sign-up, no server uploads. Your content never leaves your device.
+Turn your Markdown into beautiful, print-ready PDF documents — free, open-source, and 100% client-side.
+
+No ugly exports, no broken layouts. MarkBloom produces professionally formatted PDFs with smart pagination, clean typography, and syntax-highlighted code blocks. Write in the editor, see the final result live, and export with one click.
 
 [Live Demo](https://mertguvencli.github.io/markbloom)
 
@@ -9,32 +11,37 @@ Free, open-source Markdown to PDF converter that runs entirely in your browser.
 ![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript)
 ![License](https://img.shields.io/badge/License-MIT-green)
 
-## Features
+## Why MarkBloom?
+
+Most Markdown-to-PDF tools produce bland, poorly formatted output. MarkBloom is built with one goal: **beautiful PDF documents** from your Markdown.
 
-- **Live Editor** — CodeMirror 6 powered Markdown editor with syntax highlighting
-- **Real-Time Preview** — Instant side-by-side preview as you type
-- **PDF Export** — One-click export with smart pagination and page break detection
-- **Multiple Page Sizes** — A4, US Letter, and Legal support
-- **GitHub Flavored Markdown** — Tables, task lists, strikethrough, and more
-- **Syntax Highlighting** — 100+ languages with Shiki (GitHub Dark theme)
-- **100% Client-Side** — Zero backend, zero data collection, complete privacy
+- **Professional Typography** — Clean heading hierarchy, balanced spacing, and print-optimized font rendering
+- **Smart Pagination** — Intelligent page breaks that never cut tables mid-row or orphan headings
+- **Syntax-Highlighted Code** — 100+ languages with Shiki (GitHub Dark theme), rendered beautifully in PDF
+- **Multiple Page Sizes** — A4, US Letter, and Legal with proper margins and layout
+- **Styled Tables & Lists** — Bordered tables, task lists, and nested content that actually look good in PDF
+- **Live Preview** — See exactly how your PDF will look as you type, no surprises
 
-## Getting Started
+## Quick Start
 
 ```bash
-# Clone the repository
 git clone https://github.com/mertguvencli/markbloom.git
 cd markbloom
-
-# Install dependencies
 pnpm install
-
-# Start development server
 pnpm dev
 ```
 
 Open [http://localhost:3000](http://localhost:3000) in your browser.
 
+## How It Works
+
+1. Write or paste Markdown in the editor
+2. See a pixel-perfect live preview of your PDF output
+3. Choose your page size (A4, Letter, or Legal)
+4. Click **Export PDF** — done
+
+Everything runs in your browser. Your content never leaves your device.
+
 ## Tech Stack
 
 | Category | Technology |
@@ -49,14 +56,11 @@ Open [http://localhost:3000](http://localhost:3000) in your browser.
 ## Build & Deploy
 
 ```bash
-# Production build
 pnpm build
-
-# Start production server
 pnpm start
 ```
 
-The project is configured for static export and can be deployed to GitHub Pages or any static hosting provider.
+Configured for static export — deploy to GitHub Pages or any static hosting provider.
 
 ## Contributing
 
diff --git a/app/layout.tsx b/app/layout.tsx
@@ -18,19 +18,22 @@ const geistMono = Geist_Mono({
 const siteUrl = "https://mertguvencli.github.io/markbloom";
 
 export const metadata: Metadata = {
-  title: "MarkBloom — Free Online Markdown to PDF Converter",
+  title: "MarkBloom — Beautiful PDFs from Markdown | Free & Open Source",
   description:
-    "MarkBloom is a free, open-source Markdown to PDF converter. Write Markdown with live preview and export beautifully styled PDF documents with A4, Letter, and Legal page sizes. No sign-up required.",
+    "Turn Markdown into beautiful, print-ready PDF documents. Professional typography, smart pagination, syntax-highlighted code blocks, and styled tables. Free, open-source, 100% client-side — your content never leaves your browser.",
   keywords: [
+    "markdown to beautiful pdf",
     "markdown to pdf",
+    "beautiful pdf from markdown",
+    "professional pdf generator",
+    "print-ready markdown",
     "markdown pdf converter",
-    "markdown editor",
-    "online markdown to pdf",
-    "free markdown to pdf",
-    "open source markdown editor",
+    "styled markdown pdf",
     "markdown pdf export",
-    "markdown preview",
-    "tailwind pdf",
+    "free markdown to pdf",
+    "online markdown to pdf",
+    "markdown smart pagination",
+    "syntax highlighted pdf",
   ],
   authors: [{ name: "Mert Güvençli", url: "https://github.com/mertguvencli" }],
   creator: "Mert Güvençli",
@@ -40,17 +43,17 @@ export const metadata: Metadata = {
   },
   openGraph: {
     type: "website",
-    title: "MarkBloom — Free Online Markdown to PDF Converter",
+    title: "MarkBloom — Beautiful PDFs from Markdown",
     description:
-      "Free, open-source Markdown to PDF converter with live preview. Export styled PDFs in A4, Letter, and Legal sizes. No sign-up required.",
+      "Turn Markdown into beautiful, print-ready PDFs with professional typography, smart pagination, and syntax-highlighted code. Free, open-source, runs in your browser.",
     url: siteUrl,
     siteName: "MarkBloom",
   },
   twitter: {
     card: "summary_large_image",
-    title: "MarkBloom — Free Online Markdown to PDF Converter",
+    title: "MarkBloom — Beautiful PDFs from Markdown",
     description:
-      "Free, open-source Markdown to PDF converter with live preview. Export styled PDFs in A4, Letter, and Legal sizes.",
+      "Turn Markdown into beautiful, print-ready PDFs. Professional typography, smart pagination, syntax-highlighted code. Free & open-source.",
   },
   robots: {
     index: true,
@@ -67,7 +70,7 @@ const jsonLd = {
   "@type": "SoftwareApplication",
   name: "MarkBloom",
   description:
-    "Free, open-source Markdown to PDF converter with live preview. Write Markdown and export beautifully styled PDF documents in A4, Letter, and Legal page sizes.",
+    "Turn Markdown into beautiful, print-ready PDF documents with professional typography, smart pagination, and syntax-highlighted code blocks. Free, open-source, 100% client-side.",
   url: siteUrl,
   applicationCategory: "UtilitiesApplication",
   operatingSystem: "Any (Web Browser)",
@@ -88,12 +91,13 @@ const jsonLd = {
   isAccessibleForFree: true,
   license: "https://opensource.org/licenses/MIT",
   featureList: [
-    "Live Markdown editor with syntax highlighting",
-    "Real-time preview with Tailwind Typography styling",
-    "PDF export in A4, Letter, and Legal page sizes",
-    "GitHub Flavored Markdown support",
-    "Syntax-highlighted code blocks",
-    "Runs entirely in the browser",
+    "Beautiful, professionally formatted PDF output",
+    "Smart pagination with intelligent page break detection",
+    "Syntax-highlighted code blocks in PDF via Shiki",
+    "Styled tables, task lists, and blockquotes in PDF",
+    "Live preview — see your final PDF as you type",
+    "Multiple page sizes: A4, Letter, Legal",
+    "100% client-side — your content never leaves your browser",
   ],
 };
 
@@ -103,18 +107,26 @@ const faqJsonLd = {
   mainEntity: [
     {
       "@type": "Question",
-      name: "How do I convert Markdown to PDF online for free?",
+      name: "How do I create beautiful PDFs from Markdown?",
+      acceptedAnswer: {
+        "@type": "Answer",
+        text: "Open MarkBloom, write or paste your Markdown, and click Export PDF. MarkBloom automatically applies professional typography, smart page breaks, and polished styling to produce print-ready PDF documents. No sign-up or installation required.",
+      },
+    },
+    {
+      "@type": "Question",
+      name: "Why do my Markdown PDFs look ugly with other tools?",
       acceptedAnswer: {
         "@type": "Answer",
-        text: "Open MarkBloom in your browser, paste or type your Markdown in the editor, preview it in real time, then click Export PDF. No sign-up or installation required.",
+        text: "Most Markdown-to-PDF tools use basic styling with minimal attention to typography, pagination, or layout. MarkBloom is built specifically to produce beautiful output — with intelligent page breaks that avoid cutting tables or orphaning headings, syntax-highlighted code blocks, and professionally styled tables and lists.",
       },
     },
     {
       "@type": "Question",
       name: "What page sizes does MarkBloom support?",
       acceptedAnswer: {
         "@type": "Answer",
-        text: "MarkBloom supports A4, US Letter, and Legal page sizes for PDF export.",
+        text: "MarkBloom supports A4, US Letter, and Legal page sizes for PDF export, each with proper margins and layout.",
       },
     },
     {
@@ -130,7 +142,7 @@ const faqJsonLd = {
       name: "Does MarkBloom support GitHub Flavored Markdown?",
       acceptedAnswer: {
         "@type": "Answer",
-        text: "Yes. MarkBloom supports GitHub Flavored Markdown (GFM) including tables, task lists, strikethrough, and syntax-highlighted code blocks.",
+        text: "Yes. MarkBloom supports GitHub Flavored Markdown (GFM) including tables, task lists, strikethrough, and syntax-highlighted code blocks — all rendered beautifully in the PDF output.",
       },
     },
     {
diff --git a/app/page.tsx b/app/page.tsx
@@ -42,7 +42,7 @@ export default function Home() {
           </div>
           <Separator orientation="vertical" className="h-6" />
           <p className="text-sm text-zinc-500">
-            Free Online Markdown to PDF Converter
+            Beautiful PDFs from Markdown
           </p>
         </div>
 
@@ -119,42 +119,56 @@ export default function Home() {
       <footer className="sr-only" aria-label="About MarkBloom">
         <h2>What is MarkBloom?</h2>
         <p>
-          MarkBloom is a free, open-source Markdown to PDF converter that runs
-          entirely in your browser. Write or paste Markdown in the editor, see a
-          live-styled preview, and export to PDF in A4, Letter, or Legal page
-          sizes — no sign-up, no server uploads, no data leaves your device.
+          MarkBloom turns your Markdown into beautiful, print-ready PDF documents.
+          Unlike other converters that produce bland, poorly formatted output,
+          MarkBloom focuses on professional typography, smart pagination, and
+          polished styling — so your PDFs actually look good. It runs entirely in
+          your browser with no sign-up, no server uploads, and no data leaving
+          your device.
         </p>
 
-        <h2>Features</h2>
+        <h2>Why MarkBloom Produces Better PDFs</h2>
         <ul>
-          <li>Live Markdown editor with syntax highlighting powered by CodeMirror</li>
-          <li>Real-time preview styled with Tailwind Typography</li>
-          <li>One-click PDF export in A4, Letter, and Legal page sizes</li>
-          <li>Full GitHub Flavored Markdown support: tables, task lists, strikethrough</li>
-          <li>Syntax-highlighted code blocks via Shiki</li>
+          <li>Professional typography with clean heading hierarchy and balanced spacing</li>
+          <li>Smart pagination that never cuts tables mid-row or orphans headings</li>
+          <li>Syntax-highlighted code blocks rendered beautifully in PDF via Shiki</li>
+          <li>Styled tables with borders, padding, and proper alignment in PDF output</li>
+          <li>Task lists, blockquotes, and nested content that look polished in print</li>
+          <li>Multiple page sizes: A4, US Letter, and Legal with proper margins</li>
+          <li>Live preview — see exactly how your PDF will look as you type</li>
           <li>100% client-side — your content never leaves your browser</li>
-          <li>Open source under the MIT license</li>
+          <li>Free and open source under the MIT license</li>
         </ul>
 
-        <h2>How to Convert Markdown to PDF</h2>
+        <h2>How to Create Beautiful PDFs from Markdown</h2>
         <ol>
           <li>Open MarkBloom in your browser</li>
-          <li>Write or paste your Markdown in the left editor panel</li>
-          <li>Preview the styled output in the right panel in real time</li>
+          <li>Write or paste your Markdown in the editor</li>
+          <li>See a pixel-perfect live preview of your PDF output</li>
           <li>Select your page size (A4, Letter, or Legal)</li>
-          <li>Click &quot;Export PDF&quot; to download your document</li>
+          <li>Click &quot;Export PDF&quot; to download your beautifully formatted document</li>
         </ol>
 
         <h2>Frequently Asked Questions</h2>
-        <h3>How do I convert Markdown to PDF online for free?</h3>
+        <h3>How do I create beautiful PDFs from Markdown?</h3>
         <p>
-          Open MarkBloom in your browser, paste or type your Markdown in the
-          editor, preview it in real time, then click Export PDF. No sign-up or
-          installation required.
+          Open MarkBloom, write or paste your Markdown, and click Export PDF.
+          MarkBloom automatically applies professional typography, smart page
+          breaks, and polished styling to produce print-ready PDF documents.
+          No sign-up or installation required.
+        </p>
+
+        <h3>Why do my Markdown PDFs look ugly with other tools?</h3>
+        <p>
+          Most Markdown-to-PDF tools use basic styling with minimal attention to
+          typography, pagination, or layout. MarkBloom is built specifically to
+          produce beautiful output — with intelligent page breaks that avoid
+          cutting tables or orphaning headings, syntax-highlighted code blocks,
+          and professionally styled tables and lists.
         </p>
 
         <h3>What page sizes does MarkBloom support?</h3>
-        <p>MarkBloom supports A4, US Letter, and Legal page sizes for PDF export.</p>
+        <p>MarkBloom supports A4, US Letter, and Legal page sizes for PDF export, each with proper margins and layout.</p>
 
         <h3>Is MarkBloom free and open source?</h3>
         <p>
@@ -165,7 +179,8 @@ export default function Home() {
         <h3>Does MarkBloom support GitHub Flavored Markdown?</h3>
         <p>
           Yes. MarkBloom supports GitHub Flavored Markdown (GFM) including
-          tables, task lists, strikethrough, and syntax-highlighted code blocks.
+          tables, task lists, strikethrough, and syntax-highlighted code blocks —
+          all rendered beautifully in the PDF output.
         </p>
 
         <h3>Is my data safe with MarkBloom?</h3>
