避坑
- h1 标题不会生成目录,因此若想标题出现在目录,请用 h2 和 h3 标题
- 使用
![]()
插入图片时,要填写标准的相对路径,如./images/xxx.png
,不要省略前面的./
,否则图片无法正常显示 - 在非代码块中(包括行内代码)不要使用紧贴的大括号,两个同向的大括号之间加个空格
js
// 报错写法
style={{ key: value }}
// 不报错写法
style={ { key: value } }
- 侧边栏对应的文件路径要书写正确,否则侧边栏无法展示
- 若一个目录有
README.md
和sidebar.js
,则其子目录文件夹不能再有 - 总之,如果页面展示出现问题,多看看控制台的报错,一般都会有提示