首页
/ 欢迎使用HyperDown

欢迎使用HyperDown

2026-02-08 04:21:38作者:薛曦旖Francesca

这是一个加粗文本斜体文本的示例。

  • 列表项1
  • 列表项2
  • 列表项3

这是一段引用文字


现在,使用命令行工具快速转换:

```bash
php cli.php demo.md output.html

打开 output.html 文件,你会惊喜地发现Markdown文本已经完美转换为HTML格式!

💡 核心功能详解

Parser.php:解析器的智能大脑

Parser.php 是HyperDown的核心文件,包含了所有解析逻辑。使用它就像调用一个简单的函数:

require_once 'Parser.php';
$parser = new HyperDown\Parser();
$html = $parser->makeHtml($markdownText);

就是这么简单!三行代码就能完成复杂的Markdown解析工作。

支持的语法特性

HyperDown支持丰富的Markdown语法:

  • 标题:从h1到h6完整支持
  • 列表系统:有序列表、无序列表,甚至支持嵌套列表
  • 引用块:多级引用,让你的文字更有层次感
  • 代码高亮:支持缩进风格和GitHub风格的代码块
  • 文本格式化:加粗、斜体、删除线等
  • 链接和图片:内联链接、引用链接、图片嵌入
  • 表格功能:创建清晰的数据表格
  • 脚注系统:为内容添加补充说明

命令行利器:cli.php

cli.php 提供了强大的命令行接口,支持多种参数:

# 基础转换
php cli.php input.md output.html

# 启用HTML标签支持
php cli.php -h -f input.md

# 启用行号显示
php cli.php -l -f input.md

🎯 高级用法与技巧

性能优化配置

HyperDown在设计时就考虑了性能因素,但如果你需要进一步优化:

$parser = new HyperDown\Parser();

// 启用HTML标签支持
$parser->enableHtml(true);

// 启用行号显示
$parser->enableLine(true);

集成到你的项目中

将HyperDown集成到现有项目非常简单:

  1. Parser.php 复制到你的项目目录
  2. 在需要的地方引入并实例化
  3. 调用 makeHtml 方法进行转换

常见问题解决方案

问题1:特殊字符被转义 解决方案:检查是否需要启用HTML标签支持

问题2:代码块格式不正确 解决方案:确保使用正确的代码块标识符

问题3:表格渲染异常 解决方案:验证表格语法是否符合规范

🔧 实战演练

让我们通过一个完整的例子来巩固所学知识:

// 引入解析器
require_once 'vendor/autoload.php';

// 创建实例
$parser = new HyperDown\Parser();

// 准备Markdown文本
$markdown = "
# 项目介绍
这是一个使用HyperDown的示例项目。

## 功能列表
- 快速解析
- 高性能
- 易于集成

`代码示例`
echo 'Hello, HyperDown!';
";

// 执行转换
$html = $parser->makeHtml($markdown);
echo $html;
登录后查看全文
热门项目推荐
相关项目推荐