Jianpu, 简谱, “simplified notation”, numbered musical notation, is the music writing system that uses the digits 1 2 3 4 5 6 7 for the seven notes of the major scale, with octave dots above or below and underlines for shorter durations. It’s the standard notation across China, Taiwan, Indonesia, Japan, Myanmar, and pockets of the Filipino and Vietnamese music traditions, read by something on the order of a billion musicians.
For a music tradition that big, it’s striking how few good tools exist for actually writing it. The situation in 2026 is roughly:
- Two genuinely good free options (one purpose-built, one plugin)
- One serious open-source option for power users
- A handful of mobile-only options with limited English support
- Various workarounds involving Word documents, custom fonts, and brave souls
This post compares all of them honestly. We make DomiSol, so caveat emptor on point #1, but the rest of the list is what we’d recommend to a friend, including the cases where another tool would suit their workflow better than ours.
What we’re optimizing for
Different users want different things from a notation editor. The criteria we weigh below:
- Writes jianpu natively vs converts from staff. Native = the editor’s data model IS jianpu; you type
1 2 3 4 5 6 7and that’s what shows up. Converted = the editor stores staff data and renders it as numbers via a transform. Native is generally better for jianpu workflows; converted is better if you’re working in mixed notations. - Cost, free, freemium, paid.
- Platform, web, desktop, mobile.
- Learning curve, minutes, hours, or days to get a usable score out.
- Output quality, does the printed PDF look like a real Chinese-music-school jianpu page, or does it look like staff notation with numbers stuck on top?
- Sharing, can you send a score to a collaborator without forcing them to install software?
1. DomiSol, purpose-built jianpu editor
TL;DR: Web-based jianpu (and solfa) editor where the data model IS jianpu. You type 1 2 3 4 5 6 7, you see jianpu. Free during beta, no installation, share via URL.
Best for: Jianpu writers who want a clean editing experience and easy sharing. Choir directors writing SATB hymns. Indonesian, Chinese, and Taiwanese music educators teaching from a single canvas. Anyone who needs to send a score to a collaborator who doesn’t want to install software.
Pricing: Free during beta. Future Pro tier (instrument samples, staff notation export) when out of beta; jianpu editing itself stays free.
Strengths:
- Native jianpu data model, no awkward conversions, no “it almost works but the beams don’t render right” surprises
- One-click toggle between jianpu and tonic solfa for users who work in both
- WhatsApp-friendly URL sharing (the entire point of the editor for choir directors who run their groups via group chats)
- Live audio playback so you can hear what you wrote before printing
- Built-in image-to-jianpu recognition (drag in a hymnal photo, get an editable jianpu score)
- AI features: harmonize melody to SATB, transpose, lyric translation, hum-to-jianpu
Weaknesses (what we won’t claim is great yet):
- Beta software, bugs are still being shaken out
- Printed PDF output is functional but doesn’t yet match the visual polish of a Chinese-music-school typesetting house
- No staff notation editing (only export, planned for Pro tier), if you need to write staff music regularly, you need a different tool
- Limited offline mode (PWA install works but there’s no full offline editing)
Try it: dash.domisol.app
2. MuseScore + Numbered Notation plugin
TL;DR: The free, open-source desktop notation app + a community plugin that converts staff scores to jianpu output.
Best for: Users who already work in MuseScore for staff notation and need occasional jianpu output. Composers who want full control over engraving details. Anyone working in mixed notation traditions on the same score.
Pricing: Free, open source (GPL).
Strengths:
- Industry-standard notation engine, the engraving is genuinely good
- Mature ecosystem of plugins, fonts, and templates
- Strong community support; problems have answers on the MuseScore forum
- Cross-platform desktop app (Mac, Windows, Linux)
- Imports and exports MusicXML cleanly
Weaknesses:
- Workflow is staff-first, jianpu-second. You write in staff notation and convert; you can’t type jianpu directly
- The Numbered Notation plugin is community-maintained and has version-compatibility quirks across MuseScore releases
- Polyphonic scores with crossing voices can produce visual artifacts in the jianpu output
- Desktop install required, no web access, no easy sharing
- Sharing a score means sending a
.msczfile to someone who needs MuseScore installed to open it (or an exported PDF that’s no longer editable)
Try it: musescore.org, then install the Numbered Notation plugin via Plugin Manager.
3. LilyPond with the jianpu addon
TL;DR: Open-source music engraving system with a community jianpu extension. LaTeX for music, text-based input, beautifully typeset output.
Best for: Power users who like text-based workflows, want pixel-perfect engraving, and don’t mind a learning curve. Academic publishers. Anyone who wants their jianpu scores under git version control as plain text.
Pricing: Free, open source.
Strengths:
- Engraving quality is genuinely the best on this list, LilyPond output looks like a printed book
- Plain-text input means you can git-version your scores like code
- Cross-platform (Mac, Windows, Linux), runs in headless CI for batch generation
- Active jianpu addon community
Weaknesses:
- Steep learning curve, expect to spend a weekend just getting comfortable with the input syntax before you produce your first usable score
- No GUI; you write LilyPond’s text format and run a compile step to render
- Real-time playback is awkward (you compile to MIDI then play that)
- Sharing with non-LilyPond users requires exporting to PDF and giving up editability
Try it: lilypond.org, then search for the lilypond-jianpu extension on GitHub.
4. OpenJianpu
TL;DR: Research-grade open-source jianpu rendering library. Less an editor, more a typesetting toolkit.
Best for: Developers building jianpu-aware applications. Researchers. Music software companies looking for a base layer.
Pricing: Free, open source.
Strengths:
- Gives you full control over jianpu typesetting at the library level
- Useful as a building block in larger systems
Weaknesses:
- Not an editor, no GUI, no end-user workflow
- Documentation is minimal
- Community is small
Try it: Search “OpenJianpu” on GitHub.
5. Mobile apps (Jianpu Composer Android)
TL;DR: Native Android apps targeting Chinese-speaking users. Touch-first input, jianpu-native output.
Best for: Casual phone-based composition for users comfortable with Chinese-language UIs.
Pricing: Mostly free with optional in-app purchases.
Strengths:
- Optimized for touch input on phones
- Built specifically for the Chinese music education market
- Some apps include built-in instrument samples for playback
Weaknesses:
- Android-only (no iOS, no desktop, no web)
- English documentation is limited or nonexistent
- Sharing typically requires the recipient to install the same app
- Quality varies wildly between apps; do read recent Play Store reviews before installing
6. Pen and paper
TL;DR: The honest baseline. Lined paper, a pen, your handwriting.
Best for: Sketching ideas. Teaching jianpu in a classroom without devices. Backup notation for when the laptop battery dies during a Sunday rehearsal.
Pricing: Free.
Strengths:
- Zero learning curve for the tool itself
- Works without electricity, internet, or a license
- No software updates to break your workflow
- Genuinely fast for simple scores once you’ve practiced
Weaknesses:
- No playback
- No sharing without scanning or photographing
- No transposition without rewriting
- Mistakes can’t be undone cleanly
- Hard to read your own handwriting six months later
7. Microsoft Word with a custom font
TL;DR: What grandma uses. Type numbers, add underlines via the underline button, copy in dot characters from the symbol palette. Print.
Best for: Users who already know Word and just need to produce a single jianpu page for printing without learning new software.
Pricing: Word license.
Strengths:
- No new software to learn
- Familiar interface
- Works for very simple monophonic scores
Weaknesses:
- Spacing breaks down quickly for anything beyond a few measures
- Beam underlines are inconsistent
- No playback, no sharing-as-editable, no transposition
- The output is unmistakably “made in Word”, not what you’d want to hand to a paying choir
How to pick
Five practical recommendations based on your situation:
- You’re a choir director, music teacher, or church music minister and you want to start writing jianpu (or solfa) today. Use DomiSol. It’s free, web-based, and built specifically for your workflow.
- You’re already a MuseScore power user. Stay in MuseScore, install the Numbered Notation plugin, and convert your staff scores to jianpu when you need to share with jianpu-reading collaborators.
- You’re publishing a printed jianpu hymnal or songbook with serious typesetting requirements. Learn LilyPond. The investment pays off.
- You’re writing one quick score for tomorrow’s class. If you have an hour, try DomiSol. If you have ten minutes and a printer, use Word with a custom font and accept the cosmetic compromises.
- You teach jianpu to children in a classroom without computers. Use pen and paper. The notation is designed for it.
Related reading
- Free online jianpu editor, write 1 2 3 4 5 6 7 in your browser, free
- Jianpu primer: read & write 1 2 3 4 5 6 7, the underlying notation explained
- Convert sheet music to solfa or jianpu, drop a MusicXML file into DomiSol
- DomiSol vs Flat.io for choir directors, comparison if you’re choosing a general-purpose editor
Frequently asked questions
- What's the best free jianpu editor?
- DomiSol is the best free option for users who want jianpu as the native editing model, purpose-built, web-based, no installation. MuseScore + the Numbered Notation plugin is the best free option for users who already work in MuseScore and need occasional jianpu output. Both are genuinely free, no paywalls.
- Can I write jianpu in MuseScore?
- Yes, with the Numbered Notation plugin. Install via Plugin Manager, write your score in standard staff notation, then run the plugin to convert to jianpu. The conversion is solid for monophonic and simple SATB scores; complex polyphony with crossing voices can produce visual issues. Free.
- Is there a jianpu editor for Mac/Windows/Linux?
- DomiSol runs in any browser on any OS, no native installer needed. MuseScore is a free desktop app for Mac, Windows, and Linux that supports jianpu via plugin. LilyPond with the jianpu add-on works on all three platforms but requires command-line comfort.
- Can I write jianpu on my phone?
- DomiSol works on any mobile browser, try it at dash.domisol.app on your phone. Touch input works for note entry. There are also a handful of Android-only apps (Jianpu Composer is the most active) but they're geared toward Chinese-speaking users and have limited English documentation.
- How does jianpu compare to staff notation for Chinese instrumental music?
- Jianpu is the dominant notation in Chinese instrumental music (erhu, dizi, guzheng) for the same reason solfa dominates vocal music: it's movable-do, so transposition is free, and it's faster to read for melodically-driven music where pitch relationships matter more than absolute pitch. Staff notation is used for orchestral parts and Western-style ensemble work.