Markdown Blog

@mgreten/markdown-blogv2026.10.15.2· MIT(was none)· 8d agoBEHAVIORSWORKFLOWS

01README

Deterministic Markdown-to-HTML previews, hash-checked local post writes, and byte-for-byte verification. Bring your own template and deployment.

02Release Notes

Declare MIT license metadata, include a root license, and link the package documentation to the publishing-workflow article.

03Behaviors1

@mgreten/markdown-blogv2026.10.15.2markdown_blog.ts

Argument	Type	Required	Description
siteTitle?	string	no
templatePath?	string	no	Trusted UTF-8 HTML template; absolute or repo-relative. Omit for the bundled semantic HTML template
pythonExecutable?	string	no	Python executable, not a shell command; must have the pinned packages installed

fn preview(sourcePath: string)

Render a local preview without changing posts. Inspect previewPath and retain its renderHash and htmlHash before writing

Argument	Type	Required	Description
sourcePath	string	yes	Absolute or repo-relative .md file with YAML metadata and blog:content:start/end markers

fn write()

Write exactly the reviewed render to a local post. Reject stale previews and unintended overwrites. Does not build listings, commit, push or deploy

fn verify()

Fail unless the local post matches both expectedHtmlHash and the current source/template render. Does not verify remote deployment, links or images

preview(infinite)— Public metadata, immutable preview path and fingerprints

post(infinite)— Written public post metadata, path and content hash

verification(infinite)— Post verified against the pinned HTML hash and current Markdown/template

04Workflows1

@mgreten/markdown-blog/write-and-verify9803c8c0-0c56-4f88-958a-ff734501d842

Write an already reviewed Markdown preview locally, then verify its exact HTML. No deployment.

mainLocal write followed by byte verification

1.write

2.verify

05Previous Versions1

2026.10.15.1Oct 16, 2026

06Stats

100 / 100

Downloads

Archive size

17.6 KB

Repository

07Platforms

08Labels