PHPackages olliecodes/laravel-etched-blade - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. olliecodes/laravel-etched-blade AbandonedLibrary[Parsing & Serialization](/categories/parsing) olliecodes/laravel-etched-blade =============================== A Laravel package that uses blade templates to parse and convert markdown to HTML 1.0.4(4y ago)19181[8 issues](https://github.com/olliecodes/laravel-etched-blade/issues)MITPHPPHP ^7.3|^8.0 Since Jun 16Pushed 4y ago1 watchersCompare [ Source](https://github.com/olliecodes/laravel-etched-blade)[ Packagist](https://packagist.org/packages/olliecodes/laravel-etched-blade)[ RSS](/packages/olliecodes-laravel-etched-blade/feed)WikiDiscussions main Synced yesterday READMEChangelog (5)Dependencies (6)Versions (9)Used By (0) [![A Laravel package that uses blade templates to parse and convert markdown to HTML](package-banner@2x.png "Laravel Etched Blade")](package-banner@2x.png) [![Packagist Version](https://camo.githubusercontent.com/e47f109bc8796dfac87a8fc037d0897e75ec3f6f95c654bf76d5ed2fcac87e81/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c616465)](https://camo.githubusercontent.com/e47f109bc8796dfac87a8fc037d0897e75ec3f6f95c654bf76d5ed2fcac87e81/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c616465)[![Packagist PHP Version Support](https://camo.githubusercontent.com/c4ff0be68edbede5d5f5e9216ce0696e57c7eb0236495f4690c65a1bb0235f6a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c616465)](https://camo.githubusercontent.com/c4ff0be68edbede5d5f5e9216ce0696e57c7eb0236495f4690c65a1bb0235f6a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c616465)[![GitHub](https://camo.githubusercontent.com/af015fbd571a43d17b3e9474851882405d8840103884e7a021b0972e41bf4354/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c616465)](https://camo.githubusercontent.com/af015fbd571a43d17b3e9474851882405d8840103884e7a021b0972e41bf4354/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c616465)[![codecov](https://camo.githubusercontent.com/d04647b48c71cfa0051a2e958a187c37db002fff3904a145af806901496d5944/68747470733a2f2f636f6465636f762e696f2f67682f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c6164652f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d46484a34314e514d5441)](https://codecov.io/gh/olliecodes/laravel-etched-blade)[![Build Status](https://camo.githubusercontent.com/83dff5eef551624921e2202e8f15b74460d14b1384d90f22a3b7783efd1848dd/68747470733a2f2f7472617669732d63692e636f6d2f6f6c6c6965636f6465732f6c61726176656c2d6574636865642d626c6164652e7376673f6272616e63683d6d61696e)](https://travis-ci.com/olliecodes/laravel-etched-blade) Install ------- [](#install) Install via composer. ``` $ composer require olliecodes/laravel-etched-blade ``` Once installed you'll want to publish the config. ``` $ php artisan vendor:publish --provider="OllieCodes\Etched\EtchedServiceProvider" --tag=config ``` If you want to modify the default themes you can publish those too. ``` $ php artisan vendor:publish --provider="OllieCodes\Etched\EtchedServiceProvider" --tag=views ``` ### Requirements [](#requirements) This package requires the following; - PHP >= 7.3 (Including 8). - `illuminate/view` >= 8.0 < 9.0 - The view component from Laravel. - `league/commonmark` >= 1.6 < 2.0 - The PHP league commonmark library, used for parsing the Markdown. - `webuni/front-matter` >= 1.2 < 2.0 - The front matter parser. Usage ----- [](#usage) To render markdown in your blade files you can either do it inline; ``` @etched # I am a heading This is some content - I am a list - So am I but more - I'm the same - I'm less than those two @endetched ``` Or by including a markdown file (`.md`) ``` @include('markdown.content.article-1') ``` The above references the file `markdown/content/article-1.md`, and the file will be rendered by etched the same way that blade files normally are. ### Themes [](#themes) You can control the theme used for the rendered markdown in several ways. Provide it as an argument on the directive. ``` @etched('simple') ... @endetched ``` As an argument when including. ``` @include('markdown-file', ['theme' => 'simple']) ``` Or in the front-matter of the markdown. ``` --- theme: simple --- I am some content ``` If no theme is provided the value of `etched.defaults.theme` is used instead. If multiple are provided, the value from the front-matter will take precedence. ### Advanced [](#advanced) All markdown rendering is handled by the `OllieCodes\Etched\Etched::render()` method. You can use this method on an instance of `Etched` ``` app(\OllieCodes\Etched\Etched::class)->render($content, $theme); ``` Or using the facade. ``` \OllieCodes\Etched\Facades\Etched::render($content, $theme); ``` The second parameter `$theme` is optional and will default to the config value `etched.defaults.theme`. The theme will be overridden by the front-matter value if one is provided in the markdown content. ### Health Score 28 — LowBetter than 54% of packages Maintenance12 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community10 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 98.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Total 5 Last Release 1776d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/662649a96637829fc96fda162ef14e9f656b09ea8d696f37156e0da01cd5fa43?d=identicon)[ollieread](/maintainers/ollieread) --- Top Contributors [![ollieread](https://avatars.githubusercontent.com/u/469515?v=4)](https://github.com/ollieread "ollieread (54 commits)")[![adevade](https://avatars.githubusercontent.com/u/1066486?v=4)](https://github.com/adevade "adevade (1 commits)") --- Tags blade-filescommonmarklaravelmarkdownphp ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/olliecodes-laravel-etched-blade/health.svg) ``` [![Health](https://phpackages.com/badges/olliecodes-laravel-etched-blade/health.svg)](https://phpackages.com/packages/olliecodes-laravel-etched-blade) ``` ### Alternatives [graham-campbell/markdown Markdown Is A CommonMark Wrapper For Laravel 1.3k7.1M64](/packages/graham-campbell-markdown)[justinwalsh/daux.io Documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly 4.6k38.1k1](/packages/justinwalsh-dauxio)[spatie/laravel-markdown A highly configurable markdown renderer and Blade component for Laravel 4053.4M35](/packages/spatie-laravel-markdown)[tightenco/jigsaw Simple static sites with Laravel's Blade. 2.2k438.5k29](/packages/tightenco-jigsaw)[mnapoli/front-yaml 2895.6M45](/packages/mnapoli-front-yaml)[daux/daux.io Documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly 825191.0k1](/packages/daux-dauxio) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)