IETF Logo Mail Archive

[Tools-discuss] Re: RFCXML / kramdown-rfc Rosetta Stone

Mark Nottingham <mnot@mnot.net> Fri, 24 July 2026 11:17 UTC

Return-Path: <mnot@mnot.net>
X-Original-To: tools-discuss@mail2.ietf.org
Delivered-To: tools-discuss@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id D7EB711E1806D; Fri, 24 Jul 2026 04:17:34 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1784891854; bh=m5opu4SGiM90HoceK7JHAwkTeFhdG01VdWSKFlXIhOg=; h=Subject:From:In-Reply-To:Date:Cc:References:To; b=ADr7YlidvOntCWjsSBkzUj312T5wYAiRxwNjCzi/GBMP9KgM5/O2TCOA4ysjm4CHJ InOaRWWS+utfaV0+ge5FwiK245Jbbiq+VoNIX7a0AC2QLEBJOBSF+nLyOjowXNkemM m0AgXdD+gtpPSeNAR+XvU2XoBJgzDCypI3r4goXA=
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -2.799
X-Spam-Level:
X-Spam-Status: No, score=-2.799 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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=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=mnot.net header.b="GVHa3LGZ"; dkim=pass (2048-bit key) header.d=messagingengine.com header.b="i361Kc1v"
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 P71f13dcNXwa; Fri, 24 Jul 2026 04:17:34 -0700 (PDT)
Received: from fout-a3-smtp.messagingengine.com (fout-a3-smtp.messagingengine.com [103.168.172.146]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id F26CD11E18068; Fri, 24 Jul 2026 04:17:33 -0700 (PDT)
Received: from phl-compute-02.internal (phl-compute-02.internal [10.202.2.42]) by mailfout.phl.internal (Postfix) with ESMTP id 6BE8CEC00B4; Fri, 24 Jul 2026 07:17:27 -0400 (EDT)
Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-02.internal (MEProxy); Fri, 24 Jul 2026 07:17:27 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mnot.net; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1784891847; x=1784978247; bh=RGm5LjHP+yihRR1tYFz8JrVetHwHKVolP7zxinViYgI=; b= GVHa3LGZUyRvdthqPDnClbNv+XMxzK48OABxUUGH1U9/WpZGyvjza3C9y/3edtOP E8COKdy5CLVKpCivfc6NRqFx37/WEhN3CiDliJjIcQMQeSBiH/By3I2N8hPXiZrg VxhxlddZSiUrsnaoYEHDRlukP29IDBL7gING7ZJVbzoQ/ZWRw6vx4lZQIDiu5aYR fBdtshXoKSlDAOMflxq4jb0fYRuuzyftNEqQzuHv1OZk9cmHxfSCbWoIubj63vV6 XwGzC4Nb57c1X7wDb6yCWKmKGgWcSeipQ7ksOigVSlDPD62N2WoHRAwIpY/QQB4f miLv/k5i67+U4HsRDHUwSw==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1784891847; x= 1784978247; bh=RGm5LjHP+yihRR1tYFz8JrVetHwHKVolP7zxinViYgI=; b=i 361Kc1vh/4ALBSqo7XtYixsT7w9xiDtfW7Riq6jAANNkYJLgmsTLeaKluYVlEJFx VxiDmlIeWBsE16sRyMi3YuooD47sGrrk+sAEWcCFWIOl/twJCXaDwTMsKejbjspR nPgjzhgJTaJOfnt2wDJ1r8968E1OvJTz5AUCbvhMKnwAmVbtoU30/Jrg3cN4Tth/ 6uV+ptb/jpYkJJv2NJfxh9DOq02L6jtGwMamG+ExVBx2u2ImZu+gpFoZeqWoiWrc +1OLD6Jpl6oheCaqUo8c430g1yo+GEB5Ro+dYbkn7iqpga7NM1ADuq0WwUYzcvWL 2FuxGVWbVNrBWX0e0iwMw==
X-ME-Sender: <xms:x0ljavXxdcwn5p0rCfoHzP135_lhuLt2YFQ2PJIaC7RY-hU1_GnkZw> <xme:x0ljanukB5SYbv8VN8mYSUn5IuQLJeiefW2HFYQRwX04kEbtPqQ3JNfcYFzuPmvcL 4BoSGr4QlQV-ioAYfVHK1IUG9NcYdA6pffzJ3nemW5V9cgU4l6X>
X-ME-Received: <xmr:x0ljajWUPp6kh2kMRCMsnFGSy2fQXhTbqnF58-1-kkCVPtvHQADCoOOthjrFujsIx9_CHyCno4eSPwqp5n-cQqmXbymYgmfmwIINZA>
X-ME-Proxy-Cause: dmFkZTEkZsZk/9VjomXcJ2eZLxin/aofBno4ijrOusJnWGysJfvUghJpdgQvzQlUEWR7Fo KD6nA2lXyEz8wmOsOXHIX4jkIWF2nnGQJgIQX0/aDsThd3F2dP5ugVmuAQ713xWYDITlJR 5+lQh7nLEnIr1nh+uQ7Aigq1+y97COTeDOg1f7/zEKL+o9GEV8nqJTQKjt8rL0ZOipQE5P ExZIo+YChdkcwPy0/Hk9n/wR6guCkILWC9Jf3SDkl6XqNDJuCuEpwCSNKNPOauKPsWERYH fO3nZHlA8fnYoQ6pEQUfdObd6ODI/aPirXxJDepSoCi4Oj1HaBrrRul5qCIxsrBvxQVJRT gNSv90ZfMiu4EDArrksA1i75IbFvBpvxzuvAJAS/Ac/KzGQQhXzP1m7aV7NdF1gQMtTS5b roXdMiY61vnmMZzRR+dDwNQXsbW+ZgJoPPde2yysgjHWshcfBYG3CRpbxNso9SVt4BFzoQ aTPueXFJoT3yEcZMBqRxlbADCjk3hUD/xbPvkMkwTdvssxK1gZDxPkYmuqWXzeT1d7FWRn VYFWmdapihOsF0DrhT5La2q9M+vjsO+zKEkB3s3cx3PIqsip9AyKSlDhpwZMVzAWG/bDLM MeerPjkGXfeq4vxVCWnl5wrOljeTmt+ag3nO2yrexkHtbpR6m3SujXAHKraA
X-ME-Proxy: <xmx:x0ljail515NcOMxv0HEAgFlQU2Yr_EGKUXk7tz_dSzTk7jojTWvYLg> <xmx:x0ljakZ6TzcWtLbr5IbP3TviO_ImveiQ44bI5F0IBIlhb012-gFxtw> <xmx:x0ljatMBWjqJdRH0wFh2kYPkcdmI9ew92V3cEnrBPCUccedN0RxHUA> <xmx:x0ljapaOuwtL7f5wWEaTvuBumV0tVJLE5w89GkjIB9-KwYfjodnj4w> <xmx:x0ljag2WjQXDeuKtcMZhehNz-etZ-mrgoaY9ujMAfjNGIjwPS3H09wle>
Feedback-ID: ie6694242:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 24 Jul 2026 07:17:26 -0400 (EDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3864.600.51.1.1\))
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <bf3431c9-cc54-4d8b-8a4f-0b4dda888a99@staff.rfc-editor.org>
Date: Fri, 24 Jul 2026 13:17:24 +0200
Content-Transfer-Encoding: quoted-printable
Message-Id: <496FB25C-7516-401C-97B4-99ABCD694C37@mnot.net>
References: <7543ba56-c0d0-4d2a-8a78-78bd583e0ceb@staff.rfc-editor.org> <92349DA7-4D6A-428A-A5A6-D176189C3C81@mnot.net> <bf3431c9-cc54-4d8b-8a4f-0b4dda888a99@staff.rfc-editor.org>
To: Tools Team Discussion <tools-discuss@ietf.org>
X-Mailer: Apple Mail (2.3864.600.51.1.1)
Message-ID-Hash: ODVSO54JLFKQUZGJYUQMV42DKOIMJBBB
X-Message-ID-Hash: ODVSO54JLFKQUZGJYUQMV42DKOIMJBBB
X-MailFrom: mnot@mnot.net
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-tools-discuss.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>, rfc-markdown@ietf.org, "xml2rfc@ietf.org" <xml2rfc@ietf.org>
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [Tools-discuss] Re: RFCXML / kramdown-rfc Rosetta Stone
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/ASiKP7fM0A3ZBApmY7LNz6mojPM>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Owner: <mailto:tools-discuss-owner@ietf.org>
List-Post: <mailto:tools-discuss@ietf.org>
List-Subscribe: <mailto:tools-discuss-join@ietf.org>
List-Unsubscribe: <mailto:tools-discuss-leave@ietf.org>

Thanks!

I think this deserves to be directly linked in the sidebar (as well as elsewhere, of course).

Many thanks for an excellent resource,


> On 24 Jul 2026, at 10:22 am, Jean Mahoney <jmahoney@staff.rfc-editor.org> wrote:
> 
> (setting followups to tools-discuss)
> 
> On 7/24/26 9:58 AM, Mark Nottingham wrote:
>> Hi Jean,
>> That's amazing, thanks so much!  Unfortunately the site navigation makes it difficult to use without a lot of horizontal scrolling on a laptop screen -- any way to address that?
> 
> [JM] There's an open discussion/issue for wiki.js to add that functionality.
> 
> https://github.com/requarks/wiki/discussions/4891
> 
> Best regards,
> Jean
> 
>> Cheers,
>>> On 24 Jul 2026, at 9:35 am, 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
>>> 
>> --
>> Mark Nottingham   https://mnot.net/
> 

--
Mark Nottingham   https://mnot.net/

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