- 全局安装
npm i ssr-md -g
- 创建项目文件夹,任意名称,例如mymd,命令
mkdir mymd
- 进入文件夹
cd mymd
- 初始化项目
ssr-md init
可带参数p(path),例如
ssr-md init -p C:\\
- 运行
ssr-md start
可带参数p(path),例如
ssr-md start -p C:\\
- 新建项目文件夹
mkdir mymd
- npm初始化并安装包
npm init
npm i ssr-md --save
- npx运行ssr-md的init(参数同上)
npx ssr-md init
- npx运行ssr-md的start(参数同上)
npx ssr-md start
-
比如跳转链接/mds-haha,就是对应【md文件根目录/haha.md文件】
-
比如跳转链接/mds-tech--index,就是对应【md文件根目录/tech/index.md文件】
那么我们就可以在markdown文件中设置链接进行文档的跳转,推荐在主md文件下设置其他md文件的链接目录
key | type(类型) | Description(描述) | Default(默认) |
---|---|---|---|
app_port | number | 服务监听的端口号 | 8080 |
app_screct | string | cookie生成所用安全码 | 'app_sercrect1' |
app_name | string | 登录页名称 | '我的文档' |
logo_src | string | 登录页logo | "" |
favicon | string | 网站图标 href | "favicon.ico" |
max_levels | number | 最大标题层数,设置为null则不限制层数,层数限制从h1开始,既如果只有h2,h3,h4且设置了三层,那么只有h2和h3会被设置为标题 | 3 |
mds_dir | string | md目录,默认mds | 'mds' |
index_md | string | 首页md,默认index | 'index' |
need_password | boolean | 是否需要密码,才能访问 | true |
pass_expire | string | 可用天和小时,例如'day','hour','30days','12hours','2days'... 设置cookie过期时间 | 'day' |
markdown_theme | string | md主题,文件路径对应static下的css文件 | 'themes/github-markdown' |
highlight_theme | string | 代码高亮主题,来自highlight.js主题 | 'highlight/styles/vs2015.min' |
static_fold | string | 你的静态文件资源站,不要将项目根目录作为静态资源站,会很危险哦 | '' |
custom_css | string | md页的自定义css地址(可以是字符串也可以是字符串数组),如果要使用自定义css,则需要设置static_fold(静态资源文件夹),并将css文件放到static_fold对应的文件夹下 | '' |
custom_hi_css | string | 登录页的自定义css地址(可以是字符串也可以是字符串数组),如果要使用自定义css,则需要设置static_fold(静态资源文件夹),并将css文件放到static_fold对应的文件夹下 | '' |
custom_js | string | md页的自定义js地址(可以是字符串也可以是字符串数组),如果要使用自定义js,则需要设置static_fold(静态资源文件夹),并将js文件放到static_fold对应的文件夹下 | '' |
custom_hi_js | string | 登录页的自定义js地址(可以是字符串也可以是字符串数组),如果要使用自定义js,则需要设置static_fold(静态资源文件夹),并将js文件放到static_fold对应的文件夹下 | '' |
admin_password | string | 管理员密码,可以进行密码管理,通过修改.passwords文件,必须有管理员cookie | '' |
可用markdown_theme主题如下:
key | 描述 |
---|---|
themes/github-markdown | github markdown样式 |
themes/github-markdown-dark | github markdown黑暗样式 |
themes/github-markdown-light | github markdown明亮样式 |
themes/jasonm23-dark | 手机端样式 |
themes/jasonm23-foghorn | 手机端样式 |
themes/jasonm23-markdown | 手机端样式 |
themes/jasonm23-swiss | 手机端样式 |
themes/markedapp-byword | pc/手机端样式 |
themes/roryg-ghostwriter | pc/手机端样式 |
themes/sspai | pc/手机端样式 |
themes/thomasf-solarizedcssdark | pc/手机端样式 |
themes/thomasf-solarizedcsslight | pc/手机端样式 |
-
ssr-md init --help (全局安装:npx ssr-md init --help)
-
ssr-md start --help (全局安装:npx ssr-md start --help)
- 由于是ssr,那么服务器一定要有node环境
- linux命令行运行: 执行
ssr-md start
(需要配置ssr-md的环境变量或者找到ssr-md所在目录)