## 如何編寫文檔 `##`用于寫一個 h2 頭。每個文檔必須以 h2 開頭。 這是為了支持 appium.io 文檔生成。不要使用`---`下劃線方法創建標題。 不要對標題使用 h1 `#` 或 `===`，因為目錄表不支持這樣（文件夾名稱將用作 h1）。 ### 副標題 `###` 用于編寫副標題 ### 常規標題 `####` 用于不出現在目錄里的標題。 不要使用 h5 `#####` 或是 h6 `######`。 ### 換行符 不要使用 `--` 或者 `---`這樣的換行符。 ### 鏈接 鏈接到 readme : `[readme](../../README.md)` 鏈接到捐贈： `[捐贈](../../CONTRIBUTING.md)` 鏈接到另一個文件 `[鏈接文本](filename.md)` ### 寫指令（Commands）文檔 指令文檔位于 `docs/en/commands`，是程序生成的文檔，不需要直接編輯。該指令文檔定義在`commands-yml/commands`。 ### 生成指令（Commands）文檔 運行 `npm run generate-docs` 生成指令文檔。這將在 `docs/en/commands` 下生成 Markdown 文件，然后需要將生成的文件提交并推送。 ### 添加文檔到 Appium.io `docs/` 目錄下的 Markdown 文件不會自動添加到站點。為了添加文檔到 [appium.io](https://appium.io)，你需要在目錄表（[toc.js](https://github.com/appium/appium/blob/master/docs/toc.js)）中的合適的位置添加一個入口。 #### 出版 要在 [appium.io](https://appium.io) 上發布文檔，請參閱 [appium.io](https://github.com/appium/appium.io).