IETF Logo Mail Archive

Re: RFCXML / kramdown-rfc Rosetta Stone

Rohan Mahy <rohan.mahy@gmail.com> Fri, 24 July 2026 12:28 UTC

Return-Path: <rohan.mahy@gmail.com>
X-Original-To: wgchairs@mail2.ietf.org
Delivered-To: wgchairs@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id 3FDE311E2727E for <wgchairs@mail2.ietf.org>; Fri, 24 Jul 2026 05:28:32 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1784896112; bh=2T+h+hPy68mt+yFy7blWHM1j6bnobhFBheteMLWeUU4=; h=References:In-Reply-To:From:Date:Subject:To:Cc; b=C9bkZmBWOPgxZjohE/45wn2pOIlf2IMpKMKsAK3RTf1TTRzSpSWOw03pT8w0WwMXI AIQkLpOfwv8egazd7H+bCznnsGUZ1hsMxfpbA2f0v2Q17meRauewnOGR5v3qJuELJq sTuphKVdBVuFSUc4wNfSQRTSlsHVWSTGeja2/RN0=
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ag4m8ZzvkvjV for <wgchairs@mail2.ietf.org>; Fri, 24 Jul 2026 05:28:30 -0700 (PDT)
Received: from mail-wr1-x436.google.com (mail-wr1-x436.google.com [IPv6:2a00:1450:4864:20::436]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id BB2D411E27269 for <wgchairs@ietf.org>; Fri, 24 Jul 2026 05:28:30 -0700 (PDT)
Received: by mail-wr1-x436.google.com with SMTP id ffacd0b85a97d-47f96c5b722so306833f8f.0 for <wgchairs@ietf.org>; Fri, 24 Jul 2026 05:28:30 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; t=1784896110; cv=none; d=google.com; s=arc-20260327; b=W1JAnfTK/8BDgkr4215J6XSYkyNOKrZCFXBc5kl+WxQJ63DCGv1HLpEnzHd4CJ0g43 8cSLX3mTh2y3M0NX7sNUUTKAW1k34pBpmagkl9u2wiGFw3+gmUR9nbU/k1mUE10QfzR4 43sPEmCdVVppxK/VVDkzgbZN0nW93fTBSoH+VR59yNOcRLsQ45JEM+Ell1Ae7fneZCGG u6d0g33IaTNpDuLTQ7m/CrOl8Fw0JvNDNkjSrN9Kw3IocEld0nJ1P34psIgW5l27TTdk Pivh/HnB66vPjmitB1Otq7Mq8XJkVBluPq1agHzpvXHqIKgrV5TEsuwEoQSeiypEw/v8 1KZw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20260327; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:dkim-signature; bh=+Fkv1WEEMzPah1RNhDqwYmogHaikMBuIyUI+M2H4OL4=; fh=9EKfXqhGuSeL/dgN1qJu8hVU/1RQMwY2m8WgDyuISiA=; b=omH0RSckXOCKt5O9hKrR9R4ylRvaPTzhKX+PbY6wThYgqAqktMUYOWpCF/U7Wk2q9z SLp5SM6qa8iWMqZim/cOUIF8oDzVn+TpYCIFQlD4GQvJuQ2MAifesnaRfo2T1ZbT18M7 hBL92EuImcLZhfWgSL4IvS7UrrBf4IdvKSrgmqoyElwVfWVYbmvdNP4bqAqxP1RxBXVp ntnpkv6Nzf/TzDv8ik5/puBmu2lNtZ7Oz+gvl+jNnOKxN9Fr+QUPnbCag79WKoZk0+Ng SPl8gxRDV2VAIQlxytDiHE2deotrH05ECrkwnSCwMUJ+S4KT5PjI+pOk/NXp2JJ5dP0+ obDQ==; darn=ietf.org
ARC-Authentication-Results: i=1; mx.google.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1784896110; x=1785500910; darn=ietf.org; h=content-type:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:from:to:cc:subject:date:message-id:reply-to :content-type; bh=+Fkv1WEEMzPah1RNhDqwYmogHaikMBuIyUI+M2H4OL4=; b=Y7FE29zzvESyTl0jCN2mfzNVI10UVvPueALXmmsdP/WNoJ1zXKF+by8NfMCP2xLCVi 25nniBrnyiH06eFJB+Y5QFX9Xnz//vyrc0bM7v/rAHLX6jnjZiBYSEi4jKZjZzxOZGPe VQbLrxopCfc5PMMdeCpSF9VLemn3BYF4XguayQCxEj5VjM0yg8rIil32sQdMF6ZWj63B OvReHuIemPw9H0COrD3CVaTBlg2hXCGHl7Km/DtEfN+/9r0lFDc8BjWHjdWTJ8M42LKX p3N/KhbM9GXRBs1IRfk+HsjvMOokI3F39avLKCqF4vvAiddiyClg9MulIJ2yAaPSVjSt dBEg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1784896110; x=1785500910; h=content-type:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to:content-type; bh=+Fkv1WEEMzPah1RNhDqwYmogHaikMBuIyUI+M2H4OL4=; b=OK41wzpIpgV9LVtFCSmVsiACgVTha8ptKWNfZF1cGTl/jfNLV0m0DXiTva6LKvfjea IdH5d4eYvuPb4qqG1ZvaGh3NnschabVCr9WnEZ3cV9DLQ2AgRivYmJEA7zPoHfUpqxDd tDhFDYKcf8ck9riVt2cDAh+LarYAQntkpOFd8i+mlan3eb2vx7E/+eKnQlDMVyvWsiPb FmhnEOh5rYOEHON+dIqC0fHQ39A4Ej3rfnm3X78gxbe1/bTToErym0AZu4/H/2slxtvy I8LUzaHsKoEGlRhwBK1V+Zr65/O9kL1CvQjTGAsrnXGCHpBMV25uzwcaelFGUk1HTj8i dcBQ==
X-Gm-Message-State: AOJu0YxTBPgaT/wW1aQ/6AK55b3Z2BxIjTxVhbc275y/LB2U43kqap0j 9HGUwqGfEXQYd8crFZR30TJCxkNEiMst8MKX/lPUB05S/ZWCMQorjc5Uis6I+ox2mEAGy8LffHL voaFjVpluNcSXssgfdnbv3HZXDaoNviZ8Xjaj2Rc=
X-Gm-Gg: AR+sD113sKxfs577dk8mStaHXR4qq5ns3HzEG6GX3/f55ibWjIeCHcQvaVDGXbYjbZt X3b9gYWOfEGdlZtrjNqXbq62xJ8UXIq1emF0+eaG3s2/6PRQDFPi8Ru+Q4Sz+CMedT9PguTIkqe OrX122ISMcqsvVmtZ0KO607tuT3fnrVsDXMj9vCnNvpb11A5jhazz0SHJcC2K8xoNKJaFG5NaUF mg9fpAA+EoevfBPlMfEU/Ze/b2IzTYYTL1MhvqbQpPpVCjzqgYrE1db9ihpC8TAd0cChq0rb+Ai REqnJ12C1sQ6f7TZ0P8hZVgwGPHBkcE4GtFIgbC6XARFWtszpAwgL9MgfThxDxGT212VXCo/eKl 9JBI=
X-Received: by 2002:a05:6000:490b:b0:47f:97d1:4fea with SMTP id ffacd0b85a97d-47f97d157b7mr2996100f8f.38.1784896109570; Fri, 24 Jul 2026 05:28:29 -0700 (PDT)
MIME-Version: 1.0
References: <7543ba56-c0d0-4d2a-8a78-78bd583e0ceb@staff.rfc-editor.org>
In-Reply-To: <7543ba56-c0d0-4d2a-8a78-78bd583e0ceb@staff.rfc-editor.org>
From: Rohan Mahy <rohan.mahy@gmail.com>
Date: Fri, 24 Jul 2026 14:28:15 +0200
X-Gm-Features: AUfX_mwnTG4buO1Jg9dj8Awe5PKzS8OyZMcSlkR9FPNPHkWceag1J5wMsiKXMTg
Message-ID: <CAKoiRuaofG=3GS1kcRRyEE4Ciu0D2P01diHoXLbGSs88NvZafg@mail.gmail.com>
Subject: Re: RFCXML / kramdown-rfc Rosetta Stone
To: Jean Mahoney <jmahoney@staff.rfc-editor.org>
Content-Type: multipart/alternative; boundary="00000000000092712106575a820b"
Message-ID-Hash: UTXXLU5O3XXAP6HCDVSBNRE7CJ7AORTV
X-Message-ID-Hash: UTXXLU5O3XXAP6HCDVSBNRE7CJ7AORTV
X-MailFrom: rohan.mahy@gmail.com
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-wgchairs.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: WG Chairs <wgchairs@ietf.org>, Tools Team Discussion <tools-discuss@ietf.org>, rfc-markdown@ietf.org, xml2rfc@ietf.org
X-Mailman-Version: 3.3.9rc6
Precedence: list
List-Id: Working Group Chairs <wgchairs.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/EBP37oYTUcJHMjP0LNoQbFDrItY>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wgchairs>
List-Help: <mailto:wgchairs-request@ietf.org?subject=help>
List-Owner: <mailto:wgchairs-owner@ietf.org>
List-Post: <mailto:wgchairs@ietf.org>
List-Subscribe: <mailto:wgchairs-join@ietf.org>
List-Unsubscribe: <mailto:wgchairs-leave@ietf.org>

Hi Jean,
Could you please add the markdown source for code snippets that include
local files?  For example, I used the followings nippet in the SD-CWT draft.

~~~ cddl
{::include ./main-sd-cwt.cddl}
~~~
{: #cddl-issued-sd-cwt title="CDDL describing issued SD-CWT syntax"}

Thanks,
-rohan


On Fri, 24 Jul 2026, 09:36 Jean Mahoney, <jmahoney@staff.rfc-editor.org>
wrote:

> Hi all,
>
> We've added a quick reference to authors.ietf.org that shows how to
> format various document elements, such as references and tables, in both
> RFCXML and kramdown-rfc:
>
>    https://authors.ietf.org/en/rfcxml-markdown-syntax-tables
>
> Best regards,
> Jean
>
>

v2.46.0 | Report a Bug | By Email | System Status