diff --git a/app/app/blog/[slug]/page.tsx b/app/app/blog/[slug]/page.tsx
index c9de91b..80fcae8 100644
--- a/app/app/blog/[slug]/page.tsx
+++ b/app/app/blog/[slug]/page.tsx
@@ -6,6 +6,7 @@ import { BLOG_CSS } from '../blog-styles'
import EditorialShell from '@/components/editorial/shell'
import ReadingProgress from '@/components/blog/reading-progress'
import TableOfContents from '@/components/blog/toc'
+import TemplateDownload from '@/components/blog/template-download'
export function generateStaticParams() {
return getAllPosts().map((p) => ({ slug: p.slug }))
@@ -152,6 +153,14 @@ export default function BlogPostPage({ params }: { params: { slug: string } }) {
+ {post.templateDownload && (
+
+ )}
+
{post.relatedPages.length > 0 && (
Related
diff --git a/app/app/blog/blog-styles.ts b/app/app/blog/blog-styles.ts
index 303d0c4..ed8753e 100644
--- a/app/app/blog/blog-styles.ts
+++ b/app/app/blog/blog-styles.ts
@@ -31,6 +31,13 @@ export const BLOG_CSS = `
.kb-article h3{font-family:var(--font-space-grotesk),sans-serif;font-size:16px;font-weight:600;margin:28px 0 10px;color:var(--ink)}
.kb-article h4{font-family:var(--font-space-grotesk),sans-serif;font-size:15px;font-weight:600;margin:24px 0 8px;color:var(--ink)}
.kb-article code{font-family:var(--font-mono),monospace;font-size:.86em;background:var(--bg-muted);border:1px solid var(--border);padding:1px 6px;border-radius:6px;color:var(--ink)}
+.kb-article pre{background:var(--bg-muted);border:1px solid var(--border);border-radius:12px;padding:18px 20px;overflow-x:auto;margin:0 0 26px}
+.kb-article pre code{background:none;border:0;padding:0;font-size:13px;line-height:1.6;color:var(--ink-2);white-space:pre}
+.kb-article table{width:100%;border-collapse:collapse;margin:0 0 26px;font-size:14.5px}
+.kb-article th,.kb-article td{border:1px solid var(--border);padding:10px 12px;text-align:left;vertical-align:top}
+.kb-article th{background:var(--accent-light);font-family:var(--font-space-grotesk),sans-serif;font-weight:600;color:var(--ink)}
+.kb-article td{color:var(--ink-2)}
+.kb-article[dir="rtl"] th,.kb-article[dir="rtl"] td{text-align:right}
.kb-article a{color:var(--accent);text-decoration:underline;text-decoration-color:rgba(31,107,58,.3);text-underline-offset:3px}
.kb-article a:hover{text-decoration-color:var(--accent)}
.kb-article ul,.kb-article ol{margin:0 0 22px;padding-left:24px;color:var(--ink-2);font-size:16px;line-height:1.75}
@@ -44,6 +51,15 @@ export const BLOG_CSS = `
.kb-article[dir="rtl"] ul,.kb-article[dir="rtl"] ol{padding-left:0;padding-right:24px}
.kb-article[dir="rtl"] blockquote{border-left:0;border-right:3px solid var(--accent);padding:4px 20px 4px 0}
.kb-h1[dir="rtl"]{text-align:right}
+.kb-template-dl{max-width:720px;margin:0 auto 8px;padding:0 40px}
+.kb-template-dl-card{display:flex;align-items:center;gap:16px;background:var(--accent-light);border:1px solid rgba(31,107,58,.25);border-radius:14px;padding:20px 24px}
+.kb-template-dl-icon{flex-shrink:0;width:42px;height:42px;border-radius:10px;background:var(--accent);color:#fff;display:flex;align-items:center;justify-content:center;font-size:19px}
+.kb-template-dl-body{flex:1;min-width:0}
+.kb-template-dl-label{font-family:var(--font-space-grotesk),sans-serif;font-weight:600;font-size:15px;color:var(--ink);margin-bottom:2px}
+.kb-template-dl-sub{font-family:var(--font-mono),monospace;font-size:11.5px;color:var(--ink-3)}
+.kb-template-dl-btn{flex-shrink:0;background:var(--accent);color:#fff;text-decoration:none;padding:10px 20px;border-radius:8px;font-weight:600;font-size:14px;white-space:nowrap}
+.kb-template-dl-btn:hover{opacity:.9}
+@media(max-width:640px){.kb-template-dl{padding:0 20px}.kb-template-dl-card{flex-wrap:wrap}.kb-template-dl-btn{width:100%;text-align:center}}
.kb-related{max-width:720px;margin:0 auto;padding:0 40px 56px}
.kb-related-row{display:flex;gap:10px;flex-wrap:wrap}
.kb-related a{font-family:var(--font-mono),monospace;font-size:12px;color:var(--accent);text-decoration:none;border:1px solid var(--border);background:var(--surface);border-radius:999px;padding:6px 14px}
diff --git a/app/components/blog/template-download.tsx b/app/components/blog/template-download.tsx
new file mode 100644
index 0000000..3e2829b
--- /dev/null
+++ b/app/components/blog/template-download.tsx
@@ -0,0 +1,47 @@
+'use client'
+
+import posthog from 'posthog-js'
+
+/** Tracked download card for a post's free template asset. Fires PostHog + gtag on click. */
+export default function TemplateDownload({
+ href,
+ label,
+ slug,
+}: {
+ href: string
+ label: string
+ slug: string
+}) {
+ const format = href.split('.').pop()?.toUpperCase() ?? 'FILE'
+
+ const track = () => {
+ try {
+ posthog.capture('template_download', { slug, href, format })
+ } catch (_) {}
+ if (typeof window !== 'undefined' && (window as any).gtag) {
+ ;(window as any).gtag('event', 'template_download', {
+ slug,
+ href,
+ format,
+ event_category: 'content',
+ })
+ }
+ }
+
+ return (
+
+ )
+}
diff --git a/app/lib/blog.ts b/app/lib/blog.ts
index d1ae5cb..150d50e 100644
--- a/app/lib/blog.ts
+++ b/app/lib/blog.ts
@@ -6,8 +6,9 @@ import matter from 'gray-matter'
* Blog content lib — reads markdown posts from content/blog/ at build time.
* Posts are produced by the blogger routine (routines/blogger/) and validated
* by its gates before landing here, so the markdown surface is deliberately
- * small: headings, paragraphs, links, inline code, bold/italic. No external
- * markdown dependency — the renderer below covers exactly that surface.
+ * small: headings, paragraphs, links, inline code, bold/italic, GFM tables,
+ * fenced code blocks. No external markdown dependency — the renderer below
+ * covers exactly that surface.
*/
const BLOG_DIR = path.join(process.cwd(), 'content', 'blog')
@@ -28,6 +29,8 @@ export interface BlogPostMeta {
dir: 'ltr' | 'rtl'
/** Absolute-from-root path to the post's social/OG image, or null. */
ogImage: string | null
+ /** Free downloadable asset (e.g. a copy-paste template as .docx), or null. */
+ templateDownload: { href: string; label: string } | null
}
/**
@@ -98,10 +101,21 @@ function renderInline(s: string): string {
})
}
+/** True if `line` is a GFM table separator row, e.g. `|---|:--:|---|` or `---|---`. */
+function isTableSeparator(line: string): boolean {
+ const cells = line.trim().replace(/^\||\|$/g, '').split('|')
+ return cells.length > 0 && cells.every((c) => /^\s*:?-{3,}:?\s*$/.test(c))
+}
+
+function splitTableRow(line: string): string[] {
+ return line.trim().replace(/^\||\|$/g, '').split('|').map((c) => c.trim())
+}
+
/**
* Block-level markdown → HTML. Covers the post pipeline's surface:
* h1–h4 (leading h1 dropped — the page renders the frontmatter title),
- * paragraphs, unordered/ordered lists, blockquotes, hr.
+ * paragraphs, unordered/ordered lists, blockquotes, hr, GFM tables,
+ * fenced code blocks, `:::key/note/warn` callouts.
*/
export function renderMarkdown(md: string): string {
const lines = md.split(/\r?\n/)
@@ -109,6 +123,7 @@ export function renderMarkdown(md: string): string {
let para: string[] = []
let list: { tag: 'ul' | 'ol'; items: string[] } | null = null
let callout: { kind: string; lines: string[] } | null = null
+ let codeFence: string[] | null = null
let firstH1Dropped = false
const flushPara = () => {
@@ -124,9 +139,26 @@ export function renderMarkdown(md: string): string {
}
}
- for (const raw of lines) {
+ for (let i = 0; i < lines.length; i++) {
+ const raw = lines[i]
const line = raw.trimEnd()
+ // Fenced code blocks: ```[lang] ... ``` →
, content preserved verbatim (not reflowed).
+ if (codeFence) {
+ if (/^```\s*$/.test(line)) {
+ out.push(`${escapeHtml(codeFence.join('\n'))}
`)
+ codeFence = null
+ } else {
+ codeFence.push(raw)
+ }
+ continue
+ }
+ if (/^```/.test(line)) {
+ flushPara(); flushList()
+ codeFence = []
+ continue
+ }
+
// Callout fences: :::key ... ::: → styled