对于章节与标签，只允许使用一部分元素。mkvmerge(1) 将自动移除规范所不允许的元素。

默认的语言代码为「und」，即「undefined（未定义）」。

详情请参见下文关于 剪辑信息 XML 文件 的段落。

若 SID 以“=”开头，则其剩余部分将作为 Matroska 文件解析，将读取并使用该文件的剪辑 UID。

创建的每个文件都包含一个剪辑，每个剪辑有一个剪辑 UID。如果指定的剪辑 UID 比创建的剪辑多，则多余的 UID 将被忽略。如果指定的 UID 比创建的剪辑少，则将随机创建 UID。

此选项可用于简单章节文件与包含章节但不含章节语言信息的输入文件，如 MP4 与 OGM 文件。

本选项设置的语言也将用于 --generate-chapters 选项 所生成的章节。

此开关亦可应用到从特定容器类型，如 Ogg/OGM 和 MP4 文件中复制而来的章节。 详情参见下文关于章节的段落。

o/p: 按 o/p 调整时间戳以修复线性偏移。如果省略 p 则默认为 1。o 与 p 均可为浮点数。

默认: 无手动同步校正 (与 d = 0 及 o/p = 1.0 效果相同)。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

新章节的名称由选项 --generate-chapters-name-template 控制。语言通过 --chapter-language 设置，该选项必须出现在 --generate-chapters 之前。

模板中可以使用多个变量，这些变量将在生成章节时被实际值替代。字符串 '<NUM>' 将被章节号替代。字符串 '<START>' 将被章节的起始时间戳替代。

字符串“<FILE_NAME>”与“<FILE_NAME_WITH_EXT>” 仅在为追加文件生成章节时被填充。它们会被替换为追加文件的名称，分别省略扩展名、包含扩展名。注意只会插入文件的基本名称与扩展名，不包括其目录或盘符。

您可以以 '<NUM:位数>' 的形式指定章节编号的最少位数，如 '<NUM:3>'。最终的数字，若其位数小于指定位数，则将在开头补零。

您可以以 <START:格式>的形式控制起始时间戳的格式。若未给出格式，则默认为 '%H:%M:%S'。有效的格式代码包括:

如果此选项未给定则 mkvmerge(1) 默认使用 '%p - %t' 格式 (表演者, 后接空格, 一个破折号, 另一个空格以及标题)。

如果给定了格式，则除了后续的标签字符以外都将被原样复制，标签字符将被进行下述替换:

如果未使用数字，mkvmerge(1) 将在每个簇中放置最多 n 个数据块。最大块数是 65535。

如果数字 d 后缀有 'ms'，mkvmerge(1) 将在每个簇中放置最多 d 毫秒的数据。d 的最小值是 '100ms'，最大值是 '32000ms'。

mkvmerge(1) 默认每簇最多放置 65535 个数据块或 5000ms 的数据。

尝试定位到特定帧的程序只能直接定位到簇，然后需要读取整个簇（来完成定位）。因此创建较大的簇将导致定位不精确或缓慢。

通常 mkvmerge(1) 会使用数值 1000000，这样时间戳和时长的精度为 1ms。对于不包含视频轨但含有至少一条音频轨的文件，mkvmerge(1) 将自动选择一个时间戳缩放系数以使各轨的音频采样精度相同。这将引起更大的额外开销，但将允许更为精确的定位与提取。

如果使用了特殊值 -1，即使有视频轨，mkvmerge(1) 也将使用采样精度。

启用本选项可阻止 mkvmerge(1) 写入这些标签或修改现有的同名标签。

目前 mkvmerge(1) 支持四种不同的模式。

此切割模式下输出文件名将以不同于常用操作的方式对待。可能会含有类似 printf 中 '%d' 的表达式，包括可选的字段宽度，如 '%02d'。如果含有上述表达式，当前文件序号将按相应格式生成，然后插入到文件名中的相应位置。 如果没有此类匹配模式，则假定匹配模式为在文件扩展名之前插入 '-%03d': '-o 输出.mkv' 将生成 '输出-001.mkv' 这样的一系列文件。如果没有扩展名，'-%03d' 将被追加在文件名之后。

也可以选用「%c」，它将被替换为文件中首个章节的名称。注意：当「%c」存在时，不会再自动添加「-%03d」。

若 SID 以“=”开头，则其剩余部分将作为 Matroska 文件解析，将读取并使用该文件的剪辑 UID。

若 SID 以“=”开头，则其剩余部分将作为 Matroska 文件解析，将读取并使用该文件的剪辑 UID。

当 mkvmerge 将来自另一文件 (本段中假设为 '文件2') 的一条轨道 (假设为 '轨道2_1' ) 追加合并到首个文件 (假设为 '文件1')的一条轨道 (假设为 '轨道1_1') 时，它将为 '轨道2_1' 的所有时间戳设定一定量的延时。 对于 'file（文件）' 模式此延时量是 '文件1' 中遇到的最大时间戳，即使此时间戳不属于轨道 '轨道1_1'。而在 track （轨道模式）下此延时为 '轨道1_1' 的最大时间戳。

不幸的是 mkvmerge 无法侦测使用哪种模式更为可靠。因此默认为 'file（文件）' 模式。'file' 模式对单独创建的文件的处理通常更好；例如在追加 AVI 或 MP4 文件时。'track（轨道）' 模式对一个大文件的完整分块的处理更好，例如对于 VOB 与 EVO 文件。

即使选用了 'track（轨道）' 模式，字母轨道也将按照 'file（文件）' 模式处理。

如果忽略本选项，则将使用标准映射。 标准映射即将当前文件的各个轨道追加到前一个文件的相应轨道（轨道 ID 相同）。 当影片被切割为多段，且各文件中轨道数和轨道 ID 相同时，这将允许简单的追加合并，命令行为 mkvmerge -o 输出.mkv 第一段.mkv +第二段.mkv。

这是用“+”连接文件名的另一种语法。因此下述两条命令是等效的:

$ mkvmerge -o 完整.mkv 文件1.mkv + 文件2.mkv
$ mkvmerge -o 完整.mkv '[' 文件1.mkv 文件2.mkv ']'

'=' 也可以放在下一个文件名的前面。因此以下两条命令等效:

$ mkvmerge -o 完整.mkv = 文件1.mkv
$ mkvmerge -o 完整.mkv =文件1.mkv

该功能可用于如 DVD 中的 VOB 文件，或是 MPEG 传输流。如果各文件有独立的头，常见的例子如独立的 AVI 或 MP4 文件，则不适用。

将文件名置于括号中还可以阻止 mkvmerge(1) 查找具有相同基名称的文件，如 = 选项 所述。因此下面两则命令行等效:

$ mkvmerge -o 输出.mkv = 文件.mkv
$ mkvmerge -o 输出.mkv '(' 文件.mkv ')'

应该注意的几件事:

可以使用 mkvextract(1) 从 Matroska 文件中提取附件文件。

除轨道 ID 以外，您还可以提供 ISO 639-2 语言代码。仅当输入文件的轨道包含语言标签时可用。

默认: 复制该类的所有轨道。

若 ID 以 ! 开头，则其意义相反: 复制该类的所有轨道，除了 ! 后面所列出的轨道。

除轨道 ID 以外，您还可以提供 ISO 639-2 语言代码。仅当输入文件的轨道包含语言标签时可用。

若 ID 以 ! 开头，则其意义相反: 复制该类的所有轨道，除了 ! 后面所列出的轨道。

除轨道 ID 以外，您还可以提供 ISO 639-2 语言代码。仅当输入文件的轨道包含语言标签时可用。

若 ID 以 ! 开头，则其意义相反: 复制该类的所有轨道，除了 ! 后面所列出的轨道。

除轨道 ID 以外，您还可以提供 ISO 639-2 语言代码。仅当输入文件的轨道包含语言标签时可用。

若 ID 以 ! 开头，则其意义相反: 复制该类的所有轨道，除了 ! 后面所列出的轨道。

如果 ID 以 ! 作为前缀，则含义相反: 复制除了列在 ! 后面的 ID 以外的所有轨道。

默认复制所有附件到所有输出文件中。

如果 ID 以 ! 作为前缀，则含义相反: 复制除了列在 ! 后面的 ID 以外的所有轨道。

o/p: 按 o/p 调整时间戳以修复线性偏移。如果省略 p 则默认为 1。o 与 p 均可为浮点数。

默认: 无手动同步校正 (与 d = 0 及 o/p = 1.0 效果相同)。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

默认值为 'iframes（仅 i 帧）'（视频及字幕轨道）或 'none（无）'（音频轨道）。参见 --no-cues 选项，后者可阻止 cue 条目的创建，无论是否使用了 --cues 选项。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

如果输入文件是 Matroska 文件，则已有足够侦测 SBR AAC 的 CodecID 了。然而，如果 CodecID 标注错误，此开关可用于更正之。

如果 mkvmerge 错将 AAC 文件侦测为 SBR，您可以将 ':0' 添加到轨道 ID。

目前只有 DTS 轨道受此选项影响。嵌入 AC-3 核心的 TrueHD 轨道以两个轨道的形式呈现，用户可以选择复制哪个轨道。DTS 无法采用这种方案，因为 HD 扩展部分不能单独解码 – 而 TrueHD 数据可以。

目前只有 AC-3、DTS 与 TrueHD 轨道受此选项影响。

如果未强制指定默认时长，mkvmerge 将尝试继承容器中（及/或特定轨道类型，如 AVC/H.264 或 MPEG-2 已编码的位流中）该轨道的默认时长。

此选项也可用于在不使用外部时间戳文件的情况下更改视频轨的 FPS（帧率）。

压缩方式 'mpeg4_p2'/'mpeg4p2' 是一种称为 '去头' 的特殊压缩方式，只对 MPEG4 part 2 视频轨可用。

部分字幕类型的默认压缩算法为 'zlib'。该算法也是大多数（如果不是所有）回放应用程序所支持的算法。无法保证对其他压缩算法的支持（'none（不压缩）' 除外）。

指定所用数值的其他方法是使用 --aspect-ratio 或 --aspect-ratio-factor 选项 (参见下文)。 这些选项是互相独立的。

指定所用数值的其他方法是使用 --aspect-ratio-factor 或 --display-dimensions 选项 (参见上下文)。这些选项相互独立。

指定所用数值的其他方法是使用 --aspect-ratio 或 --display-dimensions 选项 (参见上文)。这些选项互相独立。

有效的值及其含义如下:

0: GBR, 1: BT709, 2: unspecified, 3: reserved, 4: FCC, 5: BT470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: YCOCG, 9: BT2020 非恒定亮度, 10: BT2020 恒定亮度

例如: 对于色度抽样为 4:2:0 的视频，该参数应设为 TID:1,1。

例如: 对于色度抽样为 4:2:1 的视频，参数 --chroma-subsample 应设为 TID:1,0，Cb 抽样应设为 TID:1,0。

有效的值及其含义如下:

0: 保留, 1: ITU-R BT.709, 2: unspecified, 3: 保留, 4: gamma 2.2 曲线, 5: gamma 2.8 曲线, 6: SMPTE 170M, 7: SMPTE 240M, 8: 线性, 9: 对数, 10: 对数平方根, 11: IEC 61966-2-4, 12: ITU-R BT.1361 extended colour gamut, 13: IEC 61966-2-1, 14: ITU-R BT.2020 10 bit, 15: ITU-R BT.2020 12 bit, 16: SMPTE ST 2084, 17: SMPTE ST 428-1; 18: ARIB STD-B67 (HLG)

有效的值及其含义如下:

0: 保留, 1: ITU-R BT.709, 2: 未指定, 3: 保留, 4: ITU-R BT.470M, 5: ITU-R BT.470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: FILM, 9: ITU-R BT.2020, 10: SMPTE ST 428-1, 22: JEDEC P22 磷光体

0: 逐行扫描; 1: 隔行扫描，顶场先显示，顶场先存储; 2: 未定场序; 6: 隔行扫描，底场先显示，底场先存储; 9: 隔行扫描，底场先显示，顶场先存储; 14: 隔行扫描，顶场先显示，底场先存储

'mono'、'side_by_side_left_first'、'top_bottom_right_first'、'top_bottom_left_first'、'checkerboard_right_first'、'checkerboard_left_first'、'row_interleaved_right_first'、'row_interleaved_left_first'、'column_interleaved_right_first'、'column_interleaved_left_first'、'anaglyph_cyan_red'、'side_by_side_right_first'、'anaglyph_green_magenta'、'both_eyes_laced_left_first'、'both_eyes_laced_right_first'。

此选项可以对同一输入文件多次使用，通过每次选择不同轨道 ID 分别应用到多个轨道。

结果的输出格式可以通过 --identification-format 选项修改。

如果已知轨道存在，但未能找到，可以通过本选项更改探测百分比。 最小值 10 MB 为内置参数，无法更改。

选择'lowest' 不仅使用尽可能低的进程优先级，还会让 mkvmerge(1) 选择空闲 I/O 优先级。

种子值可以是任意字符串，并不非得是数字。

需要满足下列条件才能确保生成二进制层面完全相同的文件:

使用其他版本的 mkvmerge(1) 或其他命令行选项也有可能输出完全一致的文件，但作者不作任何保证。

$ mkvmerge -i v.mkv
文件 'v.mkv': 容器: Matroska
轨道 ID 0: 视频 (V_MS/VFW/FOURCC, DIV3)
轨道 ID 1: 音频 (A_MPEG/L3)

若输出内容通过 cmd.exe 自身重定向，例如 mkvinfo 文件.mkv > info.txt，则其字符集必为 UTF-8，且无法修改。

否则 (直接写入控制台) 将使用 Windows 函数 WriteConsoleW() 并忽略 --output-charset 选项。控制台应该能够输出已安装对应语言支持的所有 Unicode 字符 (如汉字在英文版 Windows 可能不会正常显示)。

CHAPTER01=00:00:00.000
CHAPTER01NAME=导入部分
CHAPTER02=00:02:30.000
CHAPTER02NAME=宝宝准备摇
CHAPTER03=00:02:42.300
CHAPTER03NAME=宝宝摇屋子

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE Chapters SYSTEM "matroskachapters.dtd">
<Chapters>


  <EditionEntry>


    <ChapterAtom>


      <ChapterTimeStart>00:00:30.000</ChapterTimeStart>


      <ChapterTimeEnd>00:01:20.000</ChapterTimeEnd>


      <ChapterDisplay>


        <ChapterString>短短的一节</ChapterString>


        <ChapterLanguage>chi</ChapterLanguage>


      </ChapterDisplay>


      <ChapterAtom>


        <ChapterTimeStart>00:00:46.000</ChapterTimeStart>


        <ChapterTimeEnd>00:01:10.000</ChapterTimeEnd>


        <ChapterDisplay>


          <ChapterString>那短短的一节的一部分</ChapterString>


          <ChapterLanguage>chi</ChapterLanguage>


        </ChapterDisplay>


      </ChapterAtom>


    </ChapterAtom>


  </EditionEntry>
</Chapters>

Chapters (主)


  EditionEntry (主)


    EditionUID (无符号整数，有效值域: 1 <= 值)


    EditionFlagHidden (无符号整数，有效值域: 0 <= 值 <= 1)


    EditionFlagDefault (无符号整数，有效值域: 0 <= 值 <= 1)


    EditionFlagOrdered (无符号整数，有效值域: 0 <= 值 <= 1)


    ChapterAtom (主)


      ChapterAtom (主)


      ChapterUID (无符号整数，有效值域: 1 <= 值)


      ChapterTimeStart (无符号整数)


      ChapterTimeEnd (无符号整数)


      ChapterFlagHidden (无符号整数，有效值域: 0 <= 值 <= 1)


      ChapterFlagEnabled (无符号整数，有效值域: 0 <= 值 <= 1)


      ChapterSegmentUID (二进制，有效值域: 1 <= 长度，以字节为单位)


      ChapterSegmentEditionUID (无符号整数，有效值域: 1 <= 值)


      ChapterPhysicalEquiv (无符号整数)


      ChapterTrack (主)


        ChapterTrackNumber (无符号整数，有效值域: 1 <= 值)


      ChapterDisplay (主)


        ChapterString (UTF-8 字符串)


        ChapterLanguage (UTF-8 字符串)


        ChapterCountry (UTF-8 字符串)


      ChapterProcess (主)


        ChapterProcessCodecID (无符号整数)


        ChapterProcessPrivate (二进制)


        ChapterProcessCommand (主)


          ChapterProcessTime (无符号整数)


          ChapterProcessData (二进制)

$ mkvmerge -o 文件.mkv --tags 0:标签.xml 文件.avi

Tags (主)


  Tag (主)


    Targets (主)


      TargetTypeValue (无符号整数)


      TargetType (UTF-8 字符串)


      TrackUID (无符号整数)


      EditionUID (无符号整数)


      ChapterUID (无符号整数)


      AttachmentUID (无符号整数)


    Simple (主)


      Simple (主)


      Name (UTF-8 字符串)


      TagLanguage (UTF-8 字符串)


      DefaultLanguage (无符号整数)


      String (UTF-8 字符串)


      Binary (二进制)

# timestamp format v1
assume 27.930
800,1000,25
1500,1700,30

# timestamp format v2
0
40
80

# timestamp format v3
assume 0.0
25.325
7.530,38.236
gap, 10.050
2.000,38.236