Skip to content

What Gets Converted

Included Files

Any .html file under --input that is not a navigation file is treated as a command page and converted.

Skipped Files

The following are silently skipped because they are navigation/structural pages, not command references:

PatternExample
index.htmlhtml/index.html
toc.htmlhtml/toc.html
defaultpage.htmlhtml/defaultpage.html
preface.htmlhtml/preface.html
cmdref_index.htmlhtml/cmdref_index.html
*_chapter.htmlhtml/bgp/bgp_chapter.html
*_concept.htmlhtml/ip/ip_rip_concept.html

Sections Extracted Per Page

Each command page is parsed for the following sections:

HTML section titleMarkdown output
[書式] (Syntax)Fenced code block ```
[設定値及び初期値] (Parameters & defaults)GFM tables + plain text
[説明] (Description)Plain paragraph text
[ノート] (Notes)Plain paragraph text
[使用例] (Usage examples)Plain text (if present)
[適用モデル] (Applicable models)Comma-separated list

The page title (h1) becomes the # heading. The command name (from <meta name="DC.subject">) is shown as コマンド: `cmd name`. The parent category (from the related-links footer) is shown at the bottom.

Table Handling

HTML tables (parameter value tables) are converted to GFM tables:

markdown
| 設定値 | 説明 |
| --- | --- |
| on  | データを蓄積する |
| off | データを蓄積しない |

Tables with rowspan cells lose the span information (Markdown does not support rowspan) but all cell text is preserved.

Example

Input (bgp/bgp_aggregate.html) → output (bgp/bgp_aggregate.md):

markdown
# 32.2 経路の集約の設定

**コマンド:** `bgp aggregate`

## [書式]

bgp aggregate ip_address/mask filter filter_num ... no bgp aggregate ip_address/mask [filter filter_num... ]


## [説明]
BGP で広告する集約経路を設定する。...

## [適用モデル]
RTX5000, RTX3500, RTX1220, RTX1210, RTX1200, RTX830, ...

---
**カテゴリ:** BGP

Released under the Apache 2.0 License.