# From Jekyll
URL: /bengal/docs/0.5.0/tutorials/migration/from-jekyll/
Section: migration
Description: Onboarding guide for Jekyll users migrating to Bengal
---
> For a complete page index, fetch /bengal/llms.txt.
Moving from Ruby to Python? Bengal simplifies your stack while keeping the content-first approach you know.
## Quick Wins (5 Minutes)
### What Works The Same
Jekyll
Bengal
Status
Markdown files
Markdown files
✅ Identical
YAML frontmatter
YAML frontmatter
✅ Identical
`_posts/`for blog
`content/blog/`
✅ Similar
`_data/`
`data/`
✅ Similar
Collections
Built-in
✅ Similar
Static site output
Static site output
✅ Same
### The Key Difference
Liquid templates → Bengal directives:
markdown
MARKDOWN
```
{% highlight python %}
print("Hello")
{% endhighlight %}
```python
print("Hello")
```
```
No more `{% %}`tags in your content.
## Liquid → Markdown Translation
### Code Blocks
- Jekyll (Liquid) (#)
- Bengal (#)
markdown
MARKDOWN
```
{% highlight python linenos %}
def hello():
print("Hello!")
{% endhighlight %}
```
markdown
MARKDOWN
```
```python
def hello():
print("Hello!")
```
```
### Including Files
- Jekyll (#)
- Bengal (#)
markdown
MARKDOWN
```
{% include note.html content="This is a note." %}
{% include_relative ../snippets/example.md %}
```
markdown
MARKDOWN
```
:::{note}
This is a note.
:::
:::{include} ../snippets/example.md
:::
```
### Callouts / Alerts
Jekyll doesn't have built-in callouts (you use includes or custom CSS). Bengal has them built-in:
markdown
MARKDOWN
```
:::{note}
This is a note.
:::
:::{warning}
Be careful!
:::
:::{tip}
Pro tip here.
:::
:::{danger}
Critical warning!
:::
```
### Links and References
- Jekyll (#)
- Bengal (#)
markdown
MARKDOWN
```
[Read more]({{ site.baseurl }}{% post_url 2024-01-15-my-post %})
[About]({{ "/about/" | relative_url }})
![Logo]({{ "/assets/logo.png" | relative_url }})
```
markdown
MARKDOWN
```
[Read more](/blog/2024-01-15-my-post/)
[About](/about/)
```
Tip
Bengal handles URLs automatically. No filters needed.
## Frontmatter Mapping
### Post/Page Frontmatter
- Jekyll (#)
- Bengal (#)
yaml
YAML
```
---
layout: post
title: "My Blog Post"
date: 2024-01-15 10:30:00 -0500
categories: [python, tutorial]
tags: [beginner, tips]
author: jane
excerpt: "A brief introduction..."
published: true
---
```
yaml
YAML
```
---
title: "My Blog Post"
date: 2024-01-15
category: python
tags: [tutorial, beginner, tips]
author: jane
description: "A brief introduction..."
draft: false
---
```
### Key Differences
Jekyll
Bengal
Notes
`layout: post`
Auto-detected
Based on directory
`date: 2024-01-15 10:30:00 -0500`
`date: 2024-01-15`
Simpler format
`categories: [a, b]`
`category: a`
Single category
`excerpt:`
`description:`
Different name
`published: false`
`draft: true`
Inverted logic
`permalink:`
Auto-generated
From file path
## Configuration Mapping
### Basic Site Config
- Jekyll (_config.yml) (#)
- Bengal (bengal.toml) (#)
yaml
YAML
```
title: My Site
description: A great site
baseurl: ""
url: "https://example.com"
# Build settings
markdown: kramdown
theme: minima
plugins:
- jekyll-feed
- jekyll-seo-tag
- jekyll-sitemap
# Collections
collections:
docs:
output: true
permalink: /docs/:path/
```
toml
TOML
```
[site]
title = "My Site"
description = "A great site"
baseurl = "https://example.com"
theme = "bengal"
# Feed, SEO, sitemap are built-in
# No plugins needed
# Collections auto-detected from content/
```
### No Plugin Configuration
Jekyll features that require plugins are built into Bengal:
Jekyll Plugin
Bengal
`jekyll-feed`
Built-in RSS/Atom
`jekyll-seo-tag`
Built-in meta tags
`jekyll-sitemap`
Built-in sitemap
`jekyll-toc`
Built-in TOC
`jekyll-redirect-from`
Redirect in frontmatter
`jekyll-paginate`
Built-in pagination
`jekyll-archives`
Built-in archives
## Directory Structure Comparison
Jekyll
Bengal
Notes
`_posts/`
`content/blog/`
Blog posts
`_drafts/`
Use`draft: true`
Frontmatter flag
`_pages/`
`content/`
Regular pages
`_data/`
`data/`
YAML/JSON data
`_includes/`
`themes/[name]/templates/partials/`
Reusable snippets
`_layouts/`
`themes/[name]/templates/`
Page templates
`_sass/`
`themes/[name]/assets/css/`
Stylesheets
`assets/`
`assets/`
✅ Same
`_config.yml`
`bengal.toml`
Configuration
`Gemfile`
`pyproject.toml`
Dependencies
## Template Variable Mapping
### Page Variables
Jekyll (Liquid)
Bengal (Jinja2)
Notes
`From Jekyll`
`From Jekyll`
✅ Same
`{{ page.date }}`
`{{ page.date }}`
✅ Same
``
`{{ content }}`
Use`{{ content }}`for rendered HTML (preferred). `` also works.
`Moving from Ruby to Python? Bengal simplifies your stack while keeping the content-first approach you know.
Quick Wins (5 Minutes)
What Works The Same
| Jekyll | Bengal | Status |
| Markdown files | Markdown... |
Moving from Ruby to Python? Bengal simplifies your stack while keeping the content-first approach you know.
Quick Wins (5 Minutes)
What Works The Same
| Jekyll | Bengal | Status |
| Markdown files | Markdown... |