用途:在编写或修订含数字列表的 Markdown 文档(指南、笔记、说明、步骤、运行手册等)时使用,让编号无需手工维护,条目间引用不易被破坏。
主要能力:一是把源码中所有有序列表项统一写成 1.,由 Markdown 渲染器自动生成显示序号,便于增删和重排并减少 diff;二是用锚点加内部链接替代“第3项”“步骤3”这类按显示编号的引用。示例:
- <span id="item-install-db"></span>データベースをインストールする
- データベースのインストール項目で設定したパスワードを入力する
锚点命名建议:使用与内容相符的前缀(如 item-、section-、step-),简短英文单词,kebab-case,同一文档内不重复;避免 item-1、item-before-this、item-temp。
使用方式:先统一列表源码为 1.;找出被后文引用或可能被引用的条目;在其正文前插入 <span id="..."></span>;把交叉引用改写为 [说明文字](#锚点) 形式,链接文字体现条目内容而非显示编号;最后检查锚点重复与失效链接。修改已有文档时,不改用户可见的条目顺序,仅把「手顺2」等易失效表述替换为锚点链接;插入新条目时同样用 1.,不重排前后源码编号。输出时除非用户另有要求,默认输出日语并使用完整 Markdown 正文,保留原有语气文体,除锚点用途外不增加 HTML。
限制:资料未说明该技能的运行环境、依赖、安装命令及是否收费。