用 IIS 部署 Markdown 生成的静态网站(Windows 实战)
为什么要将 Markdown 转成 HTML 再部署?在日常工作中,我们常用 Markdown 写项目文档、接口说明、运维手册等。Markdown 简洁易用,但直接分享 .md 文件给同事,可能面临: 非技术人员不熟悉 Markdown 语法,阅读体验差 图片、表格等元素无法优雅展示 无法统一样式,显得不够专业 而将 Markdown 转换成 带样式的 HTML,再部署到 IIS(Windows 自带 Web 服务器) 上,就能让团队成员在浏览器中直接访问,获得类似官网文档的阅读体验。 本文将完整记录: 如何使用工具将 .md 转为 .html 如何在 IIS 中配置网站并托管这些静态文件 如何解决乱码、图片失效、样式丢失等常见问题 结合 VSCode 的高效工作流 第一步:将 Markdown 转换为 HTML我尝试了多种方法,下面推荐最实用的几种,您可以根据喜好选择。 方法一:使用命令行工具 ghmd(推荐)ghmd 是一个轻量级命令行工具,能调用 GitHub API 将 Markdown 渲染成 GitHub 风格的 HTML,样式非常美观。 安装(二选一): ...
关于Git的基础操作
前言Git 是目前最流行的分布式版本控制系统,广泛应用于软件开发、文档管理等场景。本文将为初学者提供 Git 基础操作的完整指南,涵盖安装配置、基本操作流程以及常见问题的解决方案。 Git 安装官方安装Git 官网地址:Git - Downloads 根据你的操作系统(Windows、macOS 或 Linux)下载对应的安装包进行安装。 国内镜像(加速下载)对于 Windows 用户,可以使用国内镜像加速下载: CNPM Binaries Mirror GitHub 注册GitHub 是全球最大的代码托管平台,建议开发者注册使用: GitHub 官网:GitHub 推荐使用邮箱注册 从 GitHub 克隆仓库克隆(Clone)是将远程仓库复制到本地的操作,具体步骤如下: 创建本地文件夹:在电脑中新建一个文件夹用于存放项目 打开命令行:在此文件夹中打开 PowerShell 或 CMD 命令行 使用加速器(可选):如果网络较慢,可以使用 GitHub 加速器如 Watt Toolkit(可在微软商店下载) 执行克隆命令: 1git clone [仓库地址] 例如: ...
Hello World
Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub. Quick StartCreate a new post1$ hexo new "My New Post" More info: Writing Run server1$ hexo server More info: Server Generate static files1$ hexo generate More info: Generating Deploy to remote sites1$ hexo deploy More info: Deployment