讲师中心 微信公众号
AI工具推荐 视频效率加速

初级实战:如何开发一个简单的Markdown转HTML工具_字符串解析

梦芳酱_7921

梦芳酱_7921

发布时间:2026-02-28 12:57:11

|

577人浏览过

|

来源于php中文网

原创

不用现成库而手写字符串解析,因只需处理简单Markdown转换,引入marked等库会增加80%冗余代码与开销;真正难点在于解析顺序与边界控制,如嵌套、换行、贪婪匹配及安全转义。

初级实战:如何开发一个简单的markdown转html工具_字符串解析

为什么不用现成库,而要自己写字符串解析

因为只是把 # 标题 变成 <h1>标题</h1>、**加粗** 变成 <strong>加粗</strong> 这种固定模式,引入 marked 或 markdown-it 反而要处理插件、安全转义、AST 遍历——多出 80% 不需要的代码量和运行时开销。

真正卡住人的不是“怎么写”,而是“顺序”和“边界”。比如:**a*b** 里中间的 * 是不是分隔符?_hello_ world 末尾空格会不会让下划线失效?这些全靠解析逻辑的先后与贪婪控制。

  • 先处理块级元素(段落、标题、列表),再处理行内(加粗、链接),否则嵌套会错乱
  • 所有正则必须用 g 标志 + ^/$ 锚定行首行尾,否则跨行匹配会吃掉不该吃的换行
  • 原始字符串里的 不能直接进正则,得先统一成 或全转为 ,否则 Windows/Mac/Linux 换行不一致会导致匹配失败

如何用正则一行一行安全替换标题和段落

^#{1,6} 看似能抓标题,但实际会误伤代码块里的 ### comment,或被缩进干扰。正确做法是:先按 拆成行数组,对每行做 trim() 后再判断是否以 # 开头且后面紧跟空格或制表符。

段落最易踩坑:空行分隔段落,但连续两个空行不是“两个段落”,而是“一个段落+一个空段落+一个段落”——渲染时得过滤掉纯空行,否则生成多余 <p></p> <p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/xiazai/skill10828" title="财经HTML高端海报生成"><img src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="财经HTML高端海报生成" ></a> <div class="aritcle_card_info flexColumn"> <a href="/xiazai/skill10828" title="财经HTML高端海报生成">财经HTML高端海报生成</a> <p>复杂得财经如何变成清晰,适合手机看的海报?如何加上你的IP</p> </div> <a href="/xiazai/skill10828" title="财经HTML高端海报生成" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>。

  • 标题匹配用 ^(#{1,6})\s+(.+)$,注意 \s+ 而非 (空格),兼容 tab 和多个空格
  • 段落用 ^([^#\s].*)$ 匹配非空、非标题开头的行,但必须配合前后空行逻辑,不能单靠正则
  • 别忘了把最终结果用 <p>...</p> 包一层——没被其他规则捕获的纯文本行,就是段落

行内格式(加粗/斜体/链接)为什么总套不严

核心矛盾:正则默认贪婪,**a** and **b** 会被当成一个匹配 **a** and **b**,而不是两个。解决方法只有两个:.*? 非贪婪,或更稳的「从左到右扫描+状态机」。

链接尤其危险:[text](url) 里的 url 可能含括号,如 [api](/v1/users?id=1&sort=(name)),用简单正则根本没法安全提取。

  • 加粗/斜体优先用 \*\*(.*?)\*\*(非贪婪),但必须确保前后不是字母/数字/下划线,否则 word**bold**end 会错切 —— 加上 (? 和 <code>(?![\w\s]) 边界断言
  • 链接老实用两步:先用 \[([^\]]+)\]\(([^)]+)\) 提取最外层 [...](...),再对 ... 内部递归处理行内格式(避免嵌套破坏)
  • 所有替换必须用 String.prototype.replace() 的函数式回调,不能直接 replace(/.../g, '<strong>$1</strong>'),否则 $1 会被未闭合的标记污染

输出 HTML 前必须做的三件事

很多人测着测着发现中文乱码、 变成 <code><、或者 XSS 漏洞,其实就差这三步,而且顺序不能错。

  • 先对原始 Markdown 字符串做 HTML 实体转义(仅 、<code>>、&),否则后续插入的标签会被二次编码 —— 用 text.replace(/&/g, '&').replace(/, '/g, '>')
  • 再执行所有 Markdown 解析(标题、加粗、链接等),此时替换内容已是安全 HTML 片段
  • 最后对解析出的链接 href 和图片 src 单独校验:只允许 http:、https:、/、# 开头,其余一律清空或替换成 #,防 javascript:alert(1)

最常被忽略的是第一件事:不提前转义原始输入,后面所有解析结果都会被浏览器当文本渲染,<script></script> 就真的执行了。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6919

2023.08.02

sort排序函数用法
sort排序函数用法

sort排序函数的用法:1、对列表进行排序,默认情况下,sort函数按升序排序,因此最终输出的结果是按从小到大的顺序排列的;2、对元组进行排序,默认情况下,sort函数按元素的大小进行排序,因此最终输出的结果是按从小到大的顺序排列的;3、对字典进行排序,由于字典是无序的,因此排序后的结果仍然是原来的字典,使用一个lambda表达式作为key参数的值,用于指定排序的依据。

1158

2023.09.04

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1838

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2924

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6224

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6089

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7694

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

11594

2024.04.29

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 230人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn