Skip to main content
00:00
00:00

Pencil Data Story

One sheet of cream paper and a red-blue pencil: real numbers drawn mark by mark while you watch. Dots land one after another, bars are traced one by one, axes grow with the story and rescale with ratchet clicks, and a ceiling tears when the data breaks through. Blue notes for people and memories, red for records and warnings, and a camera that dives, follows the pencil and pulls back over the page. Colour only ever means value; a serif headline and mono ticks. Drawn entirely in code, in English or Chinese, landscape or portrait.

Use this style
Good for
Science explainer
Footage
Tags
Format
16:9 1920×10809:16 1080×192030fps

What to provide

Give the real data to tell (years and values, or a few categories and values) and its source, and name one or two points to stress (the first, a record, a turning point). Only the numbers you give are drawn, never invented or extrapolated; keep handwritten notes short (a year and a value, or a few words). No images needed.

What you can change

ramp
数值配色:有自然中心的数据用红蓝发散色阶(以参考期均值为中心、对称跨度);没有自然中心的数据用一种顺序色阶,色相可选 red 红、blue 蓝、ink 墨;颜色只表示数值,不为了戏剧效果拉伸色阶
accent
可选一种强调色,只给不是数据的标记(如一个高亮);其余一律奶油纸上的墨色
pencil
铅笔两头的含义固定:蓝色写人、回忆和普通批注,红色写纪录和警示

Limitations

  • 支持 16:9 横版与 9:16 竖版、30 fps;同一段 scene.js 按 k.portrait 给两种画幅各自摆位
  • 画面只画真实数字:点线、柱、色带、阈值线、空格;数据只来自已确认内容,不编造、不外推、不补缺
  • 图表种类以点线序列和柱状为主;地图、桑基图、华夫图等需要段自己用 k.shape / k.stroke 画,没有现成函数
  • 画面不放照片和视频素材,全部由代码画在一张纸上;不写口播原文,字幕归平台
  • 中文手写用 Long Cang,标题用平台的 Noto Serif SC;手写批注宜短(一个年份加一个数,或三到六个词)
  • 不自带配乐、音效和上游的数据可听化

More examples

How long is a year?

How long is a year?

The headline is set on an empty chart, then the pencil traces one bar per planet: Mercury's 88 days, Venus, Earth circled as "ours", Mars. Jupiter breaks the axis, which rescales with ratchet clicks, Saturn and Uranus push it again, and Neptune's dark bar closes on a red note: 59,800 days, about 164 of our years.

Pencil Data Story · 16:9 · 10.0s