BranchesTags

Repository files navigation


Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have additional features that you want, don't worry, since markata is built completely on plugins you can develop and install your own plugins to add the features you want.

This has been a pet project for me to learn library development, plugin driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.

UPCOMING NEXT RELEASE

The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.

Disclaimer

Make sure that you pin down what version of markata you want to use. If you are starting a new project that's probably the latest version from pypi. Things are likely to change in major releases, I do my best to document them, and not to break patches.

QuickStart

Markata is fully configurable through a markata.toml file, but the defaults allow to build your site right out of the box with nothing more than Markdown.

Installation

markata is hosted on pypi and can be installed using pip.

python -m pip install markata
# or if pipx is your thing
pipx install markata

Building a Blog with Markata using a template

The markata cli includes a new command that will present you with questions to fill in the jinja variables in this repo.

markata new blog [directory]
markata build
# start the site and watch for changes
markata serve

Now if you open localhost:8000, you will be presented with an example site that will walk you through some features of markata. You can play with it at your own pace, or drop all the pages and start writing your own content.

new blog gif

Motivation

Markata is able to build your site purely from Markdown, allowing you to get started creating your own content quickly. Out of the box it will cover your seo tags, rss feeds, sitemap, and og images. Since it is built completely from plugins you can remove, modify, or add to any of its behavior.

  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image

Using Markata

The docs are still a work in progress, but the base_cli walks through how to effectively use the markata build command. At this point Markata is far from stable and will change quite a bit, should you choose to use it on real site make sure you pin to the version that you want to build from. I will let you know as it becomes more stable and ready to use without diligence of pinning to the version you want.

Honestly A big motivation for me was wanting to learn and understand how to create a project that is completely plugin driven. This is highly a learning project for me, and it has grown into something I use every day.

Examples Gallary

Markata has a project gallery to show off sites built with markata. Please submit yours, and check out the project-gallery for inspiration.

About

A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.

markata.dev

Topics

hacktoberfestmarkatamarkdownstatic-site-generator

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

93 stars

Watchers

1 watching

Forks

6 forks
Report repository

Releases

Sponsor this project

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation

Markata

Markdown to site, plugins all the way down

A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
This has been a pet project for me to learn library development, plugin
driven design, diskcache, and more. It is the core of what builds my own site waylonwalker.com.
UPCOMING NEXT RELEASE
The next release will be jinja filled. Out with all the single file templates, template strings, looping through card generation, we will have a proper jinja env with includes, bases, and all the things. It will be much easier to maintain and render faster.
Disclaimer
Make sure that you pin down what version of markata you want to use. If you
are starting a new project that's probably the latest version from
pypi. Things are likely to change in major
releases, I do my best to document them, and not to break patches.
QuickStart
Markata is fully configurable through a markata.toml file, but the defaults
allow to build your site right out of the box with nothing more than Markdown.
Installation
markata is hosted on pypi and can be installed using pip.
python -m pip install markata
# or if pipx is your thing
pipx install markata
Building a Blog with Markata using a template
The markata cli includes a new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory]
markata build
# start the site and watch for changes
markata serve
Now if you open localhost:8000, you will be presented with an example site that
will walk you through some features of markata. You can play with it at
your own pace, or drop all the pages and start writing your own content.
new blog gif
Motivation
Markata is able to build your site purely from Markdown, allowing you to get
started creating your own content quickly. Out of the box it will cover your
seo tags, rss feeds, sitemap, and og images. Since it is built completely from
plugins you can remove, modify, or add to any of its behavior.
  • configurable
  • plugins
  • seo
  • rss
  • sitemap
  • og-image
Using Markata
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to
create a project that is completely plugin driven. This is highly a learning
project for me, and it has grown into something I use every day.
Examples Gallary
Markata has a project gallery to show off sites built with markata. Please
submit yours, and check
out the project-gallery for inspiration.
About
A plugins all the way down static site generator written in python. Plugins all the way down means that you can completely change the behavior of how it works by swapping plugins, installing new ones, or creating your own all in python.
markata.dev
Topics
hacktoberfestmarkatamarkdownstatic-site-generator
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
93 stars
Watchers
1 watching
Forks
6 forks
Report repository
Releases
Sponsor this project
Used by
Contributors
Languages