skip to navigation
skip to content

id2xml 1.3.0

Convert text-format RFCs and Internet-Drafts to .xml format

Internet-Draft text to XML Conversion Tool

This tool, ‘id2xml’, is intended for use by the RFC-Editor staff, in order to produce a first xml2rfc-compatible XML version from text-only Internet-Draft submissions.

id2xml may also be useful for Internet-Draft authors who wish to start working on a new version of an older draft or RFC, for which no xml2rfc-compatible XML source is available.

Version 1.x can process the drafts specified in the development Statement of Work to XML files acceptable to xml2rfc, and can also process a number of other test files to acceptable XML. Missing is internal <xref/> links to figures and tables.

The default XML produced follows RFC 7749 [1] in version 1.x of the tool. With version 1.3.0 of the tool, output according to RFC 7991 [2] is available by use of the ‘-3’ switch.

[1]Reschke, J., “The “xml2rfc” Version 2 Vocabulary”, RFC 7749, DOI 10.17487/RFC7749, February 2016, <>.
[2]Hoffman, P., “The “xml2rfc” Version 3 Vocabulary”, RFC 7991, DOI 10.17487/RFC7991, December 2016,>.


Version 1.3.0 (23 Sep 2017)

This release adds a –schema-v3 switch, which will cause id2xml to generate xml according to xml2rfc vocabulary vesion 3. Earlier it was indicated that this would be available with version 2.0.0 of id2xml, but the v3 generation was accomplished with much less of a rewrite than anticipated, and the v2 output is still the default, so a major version bump seems inappropriate.

Details from the commit log:

  • Changed a dependency from pathlib to the recommended replacement pathlib2, and added a version requirement to the xml2rfc dependency.
  • Added support for id2xml conversion to xml2rfc vocabulary version 3 format by using the v2v3 conversion component of xml2rfc. This is invoked with a new switch: -3 / –schema-v3.

Version 1.2.3 (23 Sep 2017)

  • Added support for using draft names in references to identify references that may have bibxml entries, and use those. If found, update the xref targets in the document accordingly. Updated baseline diffs.
File Type Py Version Uploaded on Size
id2xml-1.3.0.tar.gz (md5, pgp) Source 2017-09-23 160KB