norgkyll v0.0.9
Welcome aboard! NorgKyll is your go-to tool for converting Neorg files (.norg
) into beautiful, fully-functional static websites. Whether you're a Markdown veteran or new to structured text, NorgKyll bridges the gap between simplicity and power.
Installation
To install it is very simple, just type the command npm i -g norgkyll
ββ π charon at π» DESKTOP-27DNBRN in π ~ on (πΏ main β’39 β163 β)
β°Ξ» npm i -g norgkyll
added 48 packages, and changed 1 package in 12s
5 packages are looking for funding
run `npm fund` for details
What is Neorg? π€
Think of Neorg as a supercharged Markdown. Itβs a markup format designed for note-taking, life management, and pretty much anything else you can express in plaintext. Neorg works seamlessly with Neovim, making it a breeze to create, edit, and organize your notes.
Neorg in a Nutshell
Basic Syntax
- Any plain text is allowed. Example: "This is my note!"
Inline Markup
- Style your text easily: bold, italic, underline, superscript, subscript, etc.
Lists
- Create unordered or ordered lists with simple syntax.
Headings and Nesting
- Use asterisks for headings, and indent for nested content.
Tasks (TODOs)
- Turn lists into actionable tasks with TODO states: undone, done, urgent, on hold, etc.
What is NorgKyll? π
While Neorg helps you create structured content, NorgKyll lets you share it by generating a static website from your .norg
files.
NorgKyll CLI βοΈ
Usage: norgkyll <command>
Commands
- init: initializes a project with .norg templates and css
- build: Generate the static site based on your
.norg
files.
- clean: Remove the output directory and start fresh.
- help: Show help and usage instructions.
How to Use
Create a
.norg
file
Write your notes, tasks, or documentation in Neorg format.Run the CLI
Usenorgkyll build
to generate your static site.Serve or Share
Your.norg
files are now sleek, shareable HTML pages.
π Tasks
- Add link support
- Add a prompt in the cli asking for the website name
- Add support for tables
- Add table of contents support
- Improve task renderer
- fix the bold text formatting that is showing the strong tag
- Start creating documentation
- Add support for neorg image
Why NorgKyll? π
- Effortless Conversion: Turn
.norg
into HTML without breaking a sweat. - Custom Styling: Personalize your site with CSS.
- Dynamic TODOs: Keep your tasks organized and actionable on the generated site.
Get Started Today
Transform your notes into something spectacular with NorgKyll. Whether itβs project documentation, a personal blog, or keeping track of tasks, your ideas deserve to shine! π