vitepress初识

初始化

    必须在docs文件夹下的.vitepress文件夹下创建config.js文件

    title

        会被作为title标签内容的一部分渲染

        并在头部默认渲染

    description

        作为meta标签渲染

图片资源引入

    默认情况下,vitepress会对资源进行打包处理,但是public文件夹不会,如果在config.js中设置了base选项,需要相应的增加前缀,如base="/development/",则引入需要改为/development/test.jpeg

Header Anchors

    对于h1-h6标签会在内容多渲染一个#标识,用于锚点定位(当然,对应md语法来说,即#号堆砌)

导航

    导航到新页面

        docs文件夹下新建vite文件夹,并添加index.md文件作为默认页面

        在任意md文件中使用/name/的形式进行跳转

        默认会跳转index.md,也可以指定具体的文件

    锚点定位

        用于在本页面中进行定位跳转

    跳转到站外

表格

表情符号

    使用冒号包裹列表中的key

提示块

行高亮

配置代码块行号

使用vue组件

    新建components文件夹来存放公共的vue组件,与日常写法一致

    在要使用的页面(.md文件)中注册,任意位置均可,不过个人愿意放置到头部

    最后即可在页面中使用

你可能感兴趣的:(vitepress初识)