Features
Markdown Powered Blogging
This blog is generated entirely from markdown files. When you ran the prezet::install
command markdown files were loaded into the ./prezet
directory located at the root of your Laravel application. Here is the structure of those files:
1prezet/ 2├── .obsidian/ 3│ └── ... 4├── content/ 5│ ├── installation.md 6│ ├── configuration.md 7│ ├── features/ 8│ │ └── ... 9│ └── customize/10│ └── ...11├── images/12│ ├── markdown-20240509210223449.webp13│ └── ogimages/14│ └── ...15├── SUMMARY.md16└── prezet.sqlite
The ./prezet/content/
directory contains the actual markdown files that are converted into html when the blog is loaded.
The ./prezet/images/
directory stores the images that are referenced in the markdown files. When a markdown file references an image, the MarkdownImageExtension
automatically links those images to a packaged controller that serves the images in the most efficient format and size based on the user's device. You can find more information about how Prezet automatically optimizes images here
Inside the images directory, there is a folder called ogimages
that contains any open graph images used by the blog posts. You can learn more about using Prezet to generate open graph images here.
The SUMMARY.md
file is used to generate the structure on the left side of the page. This gives you control over the order and categories in which each post appears.
The prezet.sqlite
file holds the metadata for each post. You can read more about the Prezet index here.
#Table of Contents
If you're on desktop, you should see a table of contents on the right side of the page. This is automatically generated based on the headings in the markdown file.
#Blade Components
Much like MDX where you can include JSX components in a markdown file, Prezet lets you include blade components in your markdown files. You can read more about using blade components in markdown here.