Insatll (安装)
//> 使用composer直接安装
composer require graham-campbell/markdown
//> 或在composer.json文件require中添加如下:
"require": {
"graham-campbell/markdown": "^7.0"
}
//> 使用下面命令更新composer.json依赖管理
composer update 或 composer install
//> 注册服务器提供者类 config/app.php 中 providers数组中,添加如下:
GrahamCampbell\Markdown\MarkdownServiceProvider::class,
//> 注册门面 别名 config/app.php 中 aliases数组中,添加如下:
'Markdown' => GrahamCampbell\Markdown\Facades\Markdown::class,
//> 使用下面命令,生成makedown.php配置文件到config/makedown.php目录:
php artisan vendor:publish
安装包位置:
//> 我们讨论一下 makedown.php 文件中的 配置选项
//> 允许不安全链接(图片 | 超链接)
'allow_unsafe_links' => true,
//> HTML 输入过滤(默认使用strip_tags函数过滤:从字符串中去除HTML和PHP标记)
'html_input' => 'strip', //> 会去掉所有的HTML代码(分离所有的HTML代码)
# html_input => 'allow' 允许所有的HTML代码输出(被浏览器渲染),但是php代码会被默认注释
# html_input => escape 所有的HTML和PHP代码都会原样输出(这里的HTML代码不会被渲染)
//> makedown 启用下划线:解析为强调(被解析为:em标签) (使用形式_e_ => e)
'use_underscore' => true,
//> 启用星号解析:解析为强调(别解析为:em标签)(使用:*e* => e)
'use_asterisk' => true,
//> 启用 strong 加粗 标签解析(使用:**e** => e)
'enable_strong' => true,
//> 启用 em 标签解析(这是use_underscore和use_asterisk解析的前提)
'enable_em' => true,
//> 渲染器
'renderer' => [
'block_separator' => "\n", //> 块分离 (类比 div 标签)
'inner_separator' => "\n", //> 内联分离(类比 span 标签)
'soft_break' => "\n", //> 用于渲染软休息的字符串?
],
//> CommonMark Extensions 扩展 书写markdown 解析器 被使用(参看github)
'extensions' => [],
//> 视图集成 默认 .md .md.php .md.blade.php
'views' => true,
# 该属性开启,默认注册页面渲染器到Laravel框架使用下面语句:
return view('index'); //> 默认解析index.blade.php | index.md | index.md.php | index.md.blade.php
备注:php下的makedown感觉没有什么大的用处(如果是编辑md文件,完全可以采用makedown前端编辑器)(也只能是后台编辑md文件,前台显示时,可能用到)