md-html-cli: 🔁 CLI tool for converting markdown to a single html file. 用于将 markdown 转换为单个 html 文件的 CLI 实用工具。

md-html-cli

GitHub Repo stars GitHub forks GitHub watchers GitHub contributors GitHub last commit GitHub license GitHub closed issues GitHub closed pull requests

用于将 markdown 转换为单个 html 文件的 CLI 实用工具。
🇨🇳 中文 | 🇺🇸 English

安装

安装 Go 语言 1.17 或以上版本，然后执行以下命令：

go install github.com/GoAid/md-html-cli@latest

用例

go run github.com/GoAid/md-html-cli@latest /?

Usage:
  go run github.com/GoAid/md-html-cli@latest [OPTIONS]

Application Options:
  /i, /input:             input Markdown
  /o, /output:            output HTML
  /r, /replace:           replace content key-value pairs
  /l, /lang:              html lang attribute value, default is en
  /t, /title:             custom html title, default is output file name
  /f, /favicon:           favicon image path, if embed is used, will embed by base64 encoding
  /e, /embed              embed image by base64 encoding
      /center             whether to center the image
  /m, /mathjax            use MathJax
  /s, /span               enable table row/col span
  /b, /border:            add a border style of a specified color to image labels, e.g. gray, #eee, rgb(0,0,0)
  /c, /css:               custom css file path
      /theme:[vue|side]   output HTML theme
      /toc                generate TOC
      /level:[1|2|3|4|5]  The heading level when generating TOC (default: 3)
  /g, /gen                use HTML comments to record generation time

Help Options:
  /?                      Show this help message
  /h, /help               Show this help message

样例

GitHub Pages

此 html 页面由以下命令生成：

md-html-cli -i "example/*.md" -o gh-pages/index.html -l en -t "Example Page" -f example/img/go.png -ems -c example/css/custom-css.css --theme vue --toc --gen

示例

预览

Markdown	HTML

开发

主题模板

在 theme 文件夹中创建用于存放主题模板文件的文件夹，并在文件夹中创建同名的 .gohtml 类型模板文件。

模板变量

变量	说明
`{{ .HTMLLang }}`	HTML 语言属性值，如 `en`、`zh` 等
`{{ .HTMLTitle }}`	HTML 自定义标题，默认为输出文件名称
`{{ if .Favicon }}{{ end }}`	是否添加 `favicon.ico`
`{{ .FaviconHref }}`	`favicon.ico` 标签元素
`{{ if .TOC }}{{ end }}`	是否生成目录
`{{ if .CSS }}{{ end }}`	是否添加自定义样式
`{{ .ConvertedCSS }}`	自定义样式标签和内容
`{{ if .MathJax }}{{ end }}`	是否使用 `MathJax` 渲染数学公式
`{{ .MathJaxConfig }}`	`MathJax` 配置文件 JS 标签元素
`{{ .MathJaxTeXSVG }}`	`MathJax` 渲染工具 JS 标签元素
`{{ .ConvertedHTML }}`	转换后的 HTML 主内容
`{{ .GeneratedAt }}`	记录生成时间的 HTML 注释

模板函数

函数	说明
`{{ "<!-- HTML 标签 -->" \| safeHTML }}`	`safeHTML` 用于保留 HTML 注释
`{{ "/* CSS 内容 */" \| safeCSS }}`	`safeCSS` 用于保留 CSS 注释
`{{ "/* JS 内容 */" \| safeJS }}`	`safeJS` 用于保留 JS 注释

iTanken/md-html-cli

md-html-cli

安装

用例

样例

示例

开发

主题模板

模板变量

模板函数

鸣谢

简介

发行版

贡献者 (3)

语言

近期动态

iTanken/md-html-cli .gitee-modal { width: 500px !important; }

md-html-cli

安装

用例

样例

示例

开发

主题模板

模板变量

模板函数

鸣谢

简介

发行版

贡献者 (3)

语言

近期动态

搜索帮助

iTanken/md-html-cli