本项目是由VSCode插件EncounterPlus启发而来的小工具,主要功能是将markdown文件转译为带CSS格式的网页。本文档的完整格式请查看https://keithtsao.github.io/mdwithcss/。
其实这东西好像也没什么价值?毕竟markdown是速记工具不是画图工具。
——我自己
安装依赖
1pip install -r requirements.txt
基本使用
1# 显示帮助
2python main.py -h
3# 将markdown文档转译成同名html文件
4python main.py --filename readme.md --title 说明文档
5# 支持通过--cssfile参数指定使用的css文件,目前限一个,默认为style.css
6# 支持使用--encoding参数指定输入文件的编码格式,默认为utf-8
7# 因使用环境,目前仅支持输出gbk编码
本工具支持大部分markdown特性,具体未完全测试。
本工具转译markdown文档时,部分标签后附的{.classname}用于指定特定标签所属的类。目前支持情况如下:
支持在段后(或者标题后)通过添加{.classname}的方式来指定该<p>标签所属的类,比如本段使用了{.aligned_right},该类在style.css中指定。
支持在引文中单独留一行用于指定类,如
1> 引文
2>
3> {.classname}
支持在表格中或行末指定类,支持指定表格的title,如
1`%示例表格%`
2
3|head|head|
4|:---|:--:|
5|1234|2345|{.aligned_right}
6|1|44{.aligned_left}|
| head | head |
|---|---|
| 1234 | 2345 |
| 1 | 44 |
支持在链接中指定类,如[sometext{.classname}](someurl)。效果: