handnote
/handnote
Turn text, formulas and simple diagrams into realistic handwritten Chinese/English note images (PNG/SVG), stroke by stroke, with handwritten math and an optional write-on animation (GIF/MP4). Use when the user wants 手写笔记 / 手写图 / handwritten notes, study-note cards for Xiaohongshu or Instagram, a handwritten formula, or a "being written" animation. Not for typesetting documents or for a handwriting font file.
- Author
- rayw-lab ↗
- Repository
- handnote ↗
- Licence
- MIT
- Last repository change
- 06.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Turn text, formulas and simple diagrams into realistic handwritten Chinese/English note images (PNG/SVG), stroke by stroke, with handwritten math and an optional write-on animation (GIF/MP4). Use when the user wants 手写笔记 / 手写图 / handwritten notes, study-note cards for Xiaohongshu or Instagram, a handwritten formula, or a "being written" animation. Not for typesetting documents or for a handwriting font file.
Triggers from the description
Original author description
Turn text, formulas and simple diagrams into realistic handwritten Chinese/English note images (PNG/SVG), stroke by stroke, with handwritten math and an optional write-on animation (GIF/MP4). Use when the user wants 手写笔记 / 手写图 / handwritten notes, study-note cards for Xiaohongshu or Instagram, a handwritten formula, or a "being written" animation. Not for typesetting documents or for a handwriting font file.
How it works
- Setup (once)
- One page from text — start here
- Designed pages — page modules
- Check your work
- Write-on animation
SKILL.md preview
---
name: handnote
description: Turn text, formulas and simple diagrams into realistic handwritten Chinese/English note images (PNG/SVG), stroke by stroke, with handwritten math and an optional write-on animation (GIF/MP4). Use when the user wants 手写笔记 / 手写图 / handwritten notes, study-note cards for Xiaohongshu or Instagram, a handwritten formula, or a "being written" animation. Not for typesetting documents or for a handwriting font file.
---
# handnote · 手写笔记
handnote writes every character with its real strokes (jittered per stroke, pen-pressure ink), lays out TeX with MathJax and redraws every glyph by hand. Same `--seed` → identical output; a new seed writes the page again.
## Setup (once)
```bash
npm install github:rayw-lab/handnote
npx playwright install chromium
```
## One page from text — start here
```bash
npx handnote write "# 标题\n第一行文字,公式写在 \$…\$ 里:\$a=\\frac{F}{m}\$\n\n空行是段落间隔" -o note.png --seed 3
npx handnote write -f notes.txt -o note.png --svg # long text from a file
```
Rules for the text: `# ` starts a red title line, `$…$` is TeX, a blank line adds space, wrapping is automatic (Chinese per character, English per word). Options: `--size 44` text px, `--width 1080 --height 1440` page (3:4 default), `--plain` for blank paper, `--scale 2` PNG pixel ratio. Characters with no stroke data (rare CJK, emoji) are skipped and listed on stderr — rephrase them.
Too much text for one page? Split it into several `write` calls (one per page) rather than shrinking `--size` below ~36.
## Designed pages — page modules
For notes with highlights, boxed answers and drawings, write a page module (copy `examples/notes.js` from the package as the template) and run:
```bash
npx handnote render my-notes.js -o out/ [--pages 1,3] [--seed 7] [--svg]
```
Each page is `async (c) => {…}` on a 1080×1440 px page, y = text baseline:
`c.T(text,x,y,size,color)`, `c.M(tex,x,y,size,color)`, `c.L(['text',{m:'tex'}],x,y,size)`, `c.hl(x0,x1,yCenter,h,HL.yellow)`, `c.titleRow(title, tag)`, `c.answerBox(result)`, `c.sketch(name,{svg,bbox})` with `handStroke / handArrow / handCircle`, `c.pageNo(n)`. Colors: `INK.red/blue/navy/brown/green/gray`, highlighters `HL.yellow/green/pink/blue`.
## Check your work
`render` prints any overlapping or out-of-page ink boxes and exits with code 3 (images are still written). Fix positions until it exits 0, then **look at the PNG** — the checker only knows bounding boxes, not whether the page reads well.
## Write-on animation
```bash
npx handnote animate --text "# 手写\n\$F=ma\$" -o write.gif
npx handnote animate my-notes.js --page 1 -o page1.mp4 --all # needs ffmpeg
```
Strokes after `c.live()` in a page module are animated; `--all` writes the whole page from blank. `--live-photo <dir>` (macOS only) also exports an iPhone Live Photo.
Versions
The database has no other skills named handnote.
Database snapshot: 13.11.2026 · package version 8d016ed162ec (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 86handwritten-document-rendering
Use when a doc must look handwritten (notes, tugas). - 100convert
Use when converting a handwritten PDF (reMarkable export, tablet notes, scanned handwriting, hand-drawn diagrams or schemas) into editable Markdown, or when the user asks to transcribe handwritten notes into .md. - 100send-a-handwritten-card
Use when the user wants a real handwritten card mailed to a US address through Postedly, such as a thank-you note, birthday card, sympathy card, congratulations or client note written in real pen. Triggers include "send a handwritten thank-you card", "mail a birthday card to my… - 95handwriting
把 docx / pdf / md / txt 或任意文本渲染成手写风格的 PNG 与 PDF。当用户要求"转手写""生成手写版/手写稿""练字模板""笔记纸",或上传文档要求手写版本,或希望把刚生成的回答、论文、计划书直接转成手写稿一次性交付(不让用户自己另存再导入软件)时,使用本 skill。 - 100chinese-handwriting-studio
Generate natural Chinese handwriting pages, PNG and PDF from exact text. Use for Chinese handwritten notes, varied glyphs, reference handwriting style measurements, personal glyph banks, joined phrase samples, custom blank paper templates, and phone-photo effects. - 100glmocr-handwriting
Official skill for recognizing handwritten text from images using ZhiPu GLM-OCR API. Supports various handwriting styles, languages, and mixed handwritten/printed content. Use this skill when the user wants to read handwritten notes, convert handwriting to text, or OCR handwritten documents.