打谱入门
用一个文本文件写简谱和减字，七弦谱负责对齐、排版和导出 PDF。本文从最小例子讲起，适合作为第一次使用时的路线图。
五分钟写出第一行谱
打开编辑器，把下面这段内容粘进去，点击「渲染」即可看到预览。
title=入门
1=F 4/4
5 [s9k3] 6 [d7k5] 1' [f10k6] 2' [v8k4] | 3' [0k5] - - -
这里的 5 6 1' 2' 是简谱音高，方括号里的 s9k3、d7k5 是 JianZiPu 字体能识别的减字输入。简谱和减字分开写，但会自动排在同一个音符上下。
简谱和节奏
七弦谱的简谱部分沿用 jianpu-ly 的写法。最常用的规则如下：
| 写法 | 含义 |
|---|---|
1 2 3 4 5 6 7 | 中音区音级 |
1' | 高八度；数字后加单引号 |
1, | 低八度；数字后加逗号 |
#5 / b6 | 升号 / 降号 |
0 | 休止符 |
5 - | 延长一拍 |
q5、s5 | 八分音符、十六分音符 |
曲首常见信息可以这样写：
title=阳关三叠
subtitle=开头
composer=王维
1=F 4/4
4=72减字写法
每个音符后面可以跟一个方括号，括号内写减字。括号里既可以写 ASCII，也可以写中文，最终都会交给 JianZiPu 字体显示。
| ASCII | 中文 | 说明 |
|---|---|---|
[s9k3] | [名九勾三] | 左手名指九徽，右手勾三弦 |
[d7u5] | [中七挑五] | 左手中指七徽，右手挑五弦 |
[0k5] | [散勾五] | 散音勾五弦 |
段落性标识可以和具体指法放在同一组括号里，用空格分开，例如 [:泛起 s9k3]。详细字母表见 减字字体参考。
编辑器功能
- 实时预览：修改后自动渲染 SVG 预览；需要高质量输出时再导出 PDF。
- 编辑模式：完整、简谱、减字三种模式，便于专注在不同层次。
- 查找替换：支持正则和历史记录，适合整理长谱。
- 减字补全：在方括号里输入时，会根据常见指法和当前曲谱上下文提示候选。
- 我的曲库：浏览器本地保存常用谱例，作为补全语料。
常见问题
双高音谨慎使用。 jianpu-ly 在部分 LilyPond 版本下对 1'' 支持不稳定。古琴常用音域通常不需要双高音，建议优先用单高音写法。
如果渲染失败，先检查三件事：括号是否成对、标题行是否写成 key=value 格式、小节里的节奏是否能凑齐拍号。仍然无法定位时，可以把出问题的片段发到 反馈页面里的邮箱。