Skip to content

快速入门

本指南将帮助你在 5 分钟内开始使用 DraMark 编写剧本。

什么是 DraMark?

DraMark(Drama Markdown)是一门专为戏剧、影视及音乐剧剧本创作设计的纯文本标记语言。它是 CommonMark 的结构扩展方言,这意味着:

  • 所有标准 Markdown 语法都可用(加粗、斜体、列表等)
  • 学习曲线平缓,如果你会写 Markdown,就能快速上手 DraMark
  • 有丰富的工具生态支持

基础语法速览

1. 角色与台词

使用 @ 声明角色,后续内容都是该角色的台词:

dramark
@哈姆雷特
生存还是毁灭,这是个问题。

@奥菲利亚
殿下!

2. 场景动作

不在任何角色名下的普通文本就是场景动作(舞台指示):

dramark
哈姆雷特独自一人在城墙上徘徊,月光洒在他的身上。

@哈姆雷特 [自言自语]
我的母亲...

3. 唱段

使用 $$ 标记唱段:

dramark
$$
@汉密尔顿
我绝不会放弃这个机会!
我不会放弃,我的机会!
$$

4. 动作提示

使用 {} 在台词中插入动作提示:

dramark
@哈姆雷特
{拔剑} 来吧,毒剑!

5. 场景分隔

使用 --- 分隔场景:

dramark
第一场景结束。

---

第二场景开始。

完整示例

下面是一个完整的 DraMark 剧本示例:

dramark
---
meta:
  title: 公园相遇
  author: 新手剧作家
---

# 第一幕

公园里,夕阳西下。

@路人甲 [低声]
你看那个人,已经在长椅上坐了一下午了。

@路人乙
别多管闲事,走吧。

---

夜幕降临。

@神秘人
{缓缓抬头} 终于等到你了。

$$
@神秘人
= I've been waiting for you
我终于等到你
= In this park, at this hour
在这公园,在这时刻
$$

下一步

常见问题

Q: DraMark 和普通 Markdown 有什么区别?

DraMark 是 CommonMark 的超集。所有普通 Markdown 文件都是合法的 DraMark 文件,但 DraMark 添加了专门针对剧本创作的结构化语法,如角色声明 @、唱段标记 $$ 等。

Q: 用什么编辑器写 DraMark 最好?

任何支持 Markdown 的编辑器都可以用来编写 DraMark 文件。但我们推荐使用支持自定义语法高亮的编辑器,如:

  • VS Code + DraMark 插件
  • 我们的在线编辑器(即将发布)

Q: 如何预览渲染效果?

DraMark 是文本格式,你可以:

  1. 使用 VS Code 插件直接在编辑器中预览
  2. 使用我们的在线预览工具(即将发布)

基于 MIT 许可发布