如何通过RewriteRule将.md文件重定向到带参HTML页面并读取对应文件内容
问题定位
你的规则跑不通主要有三个核心原因:
- 没有区分两类完全不同的
.md请求:一类是用户直接在浏览器地址栏访问的md链接(需要重定向到渲染页做内容渲染),另一类是渲染页本身的JS代码拉取md源文件内容的请求(需要直接返回原始文本,不能重写)。现在的规则是只要路径带.md就全部重写到markdown.html,JS拉取的时候自然拿到的是HTML页面内容,根本不是md源文件。 - 之前想靠URI末尾加问号做标记的排除逻辑完全无效:Apache重写规则里的
%{REQUEST_URI}变量只存储域名之后、查询字符串之前的路径部分,查询字符串是独立存在%{QUERY_STRING}变量里的,URI路径本身永远不会包含问号,这个排除条件从一开始就匹配不到任何内容,等于白写。 - 原有规则的正则存在小漏洞:写
^(.*).md的时候,.没有做转义,在正则里.是匹配任意字符的通配符,会把比如myFile1md这种没有后缀的路径也误触发重写。
可落地的实现方案
不需要搞复杂的特殊标记,只要在重写逻辑里加一个明确的“放行原始md文件拉取”的分支即可,两种常用实现方式:
方案1:靠查询参数做标记(兼容性最好)
- 替换成修正后的
.htaccess规则:RewriteEngine On # 拉取时带raw=1参数的md请求,直接返回原始文件,不做后续重写 RewriteCond %{QUERY_STRING} ^raw=1$ RewriteRule \.md$ - [L] # 其他普通访问md的请求,重写到渲染页,携带md文件路径作为参数 RewriteRule ^(.*)\.md$ /markdown.html?md=$1 [QSA,L] - 修改
markdown.html里的内容拉取逻辑:从地址栏参数拿到目标md路径后,请求源文件时固定在路径后加?raw=1参数,拉到内容后完成渲染,示例核心代码:// 从当前地址栏提取目标md文件路径 const targetMdPath = new URLSearchParams(location.search).get('md'); // 拉取原始md文本,带上raw=1标记触发规则放行 fetch(`/${targetMdPath}.md?raw=1`) .then(res => res.text()) .then(mdRaw => { // 调用markdown解析库把纯文本转成HTML,注入页面对应容器,加载样式完成渲染 })
方案2:靠自定义请求头做标记(更隐蔽)
如果不希望地址栏暴露raw=1这类参数,可以让JS拉取时携带自定义请求头,重写规则识别到该请求头就直接放行:
- 修正后的
.htaccess规则:RewriteEngine On # 带内部拉取请求头的md请求直接返回原始文件 RewriteCond %{HTTP:X-Internal-MD-Fetch} =true RewriteRule \.md$ - [L] # 普通用户直接访问的md请求重写到渲染页 RewriteRule ^(.*)\.md$ /markdown.html?md=$1 [QSA,L] - 对应修改拉取逻辑,在fetch请求中加上自定义请求头即可。
注意事项
- 所有正则里需要匹配字面点号的位置,一定要转义成
\.,避免通配符误匹配。 - 规则里的
[L]标记作用是处理完当前匹配后立刻停止后续规则执行,不需要再往下走其他重写逻辑。 QSA标记的作用是把原请求携带的查询参数自动拼接到重写后的URL后面,不会丢失原有请求参数。
内容的提问来源于stack exchange,提问作者Lego
相关产品推荐
相关产品推荐

