MdJs 是一个结合了 Markdown 和 JavaScript 的轻量级文档工具,旨在帮助用户以简洁、高效的方式编写和展示文档内容。它通过扩展 Markdown 的功能,支持更灵活的链接路径、侧边栏导航以及部分 HTML 标签,从而增强文档的可读性和交互性。
- 链接到文件:支持使用相对路径链接到
docs目录下的文件,支持省略.md后缀。- 示例:
[链接到文件](1/这里就是一级目录.md)或[链接到文件](1/这里就是一级目录)
- 示例:
- 自动解析:链接路径基于
docs目录,确保文档结构清晰。
- 侧边栏的导航结构由
sidebar.md文件定义,支持多级目录导航。 - 示例:
- [首页](aboutme.md) - [一级目录](1/这里就是一级目录.md) - [二级目录](1/2/这里就是二级目录.md)
- 字体颜色:使用
<font color="...">...</font>标签可以改变文本颜色。- 示例:
<font color="red">红色文本</font>会显示为 红色文本
- 示例:
- 换行:使用
<br>标签可以在文本中强制换行。
MdJs基于 Markdown 语法,支持基本语法和扩展语法。- 支持通过 HTML 标签实现一些 Markdown 本身不支持的功能,同时保持文档的简洁性。
-
安装
-
配置
- 在
sidebar.md中定义侧边栏导航结构。 - 使用标准 Markdown 语法编写文档内容。
- 在
以下是一个简单的 sidebar.md 示例:
- [首页](aboutme.md)
- [一级目录](1/这里就是一级目录.md)
- [二级目录](1/2/这里就是二级目录.md)文档内容示例:
# 欢迎使用 MdJs
这是一个使用 `MdJs` 编写的文档示例。
<font color="red">这是一个红色文本示例。</font><br>
这是一个换行示例。- 链接路径:确保链接路径基于
docs目录,避免路径错误。 - 文件名唯一性:如果省略
.md后缀,请确保文件名在同一目录下是唯一的。 - HTML 标签使用:尽量优先使用标准 Markdown 语法,避免过度依赖 HTML 标签。
MdJs 适用于以下场景:
- 个人博客或文档网站
- 项目文档管理
- 知识库构建
MdJs 采用 MIT License,欢迎使用。