Skip to content

khoeos/Yasow

Repository files navigation

stars-shield contributors-shield issues-shield License MIT

Yasow

Logo

A bare-bone starter kit for your obsidian vault on modern web technologies.

Explore the docs »

Report Bug · Request Feature · Join discord server

Yasow

Yasow is a starter kit made with Next.js to easily put online notes or markdown content based on the operation and structure of Obsidian.

Yasow is in it's early stage, and some features are missing, some may bug, but it's already usable. Feel free to contribute to the project, or ask for features.

Why Yasow

I've created Yasow because i wanted to put my notes online, and i wanted to keep the same structure and features as Obsidian. As a developped already having servers, i didn't want to use the official feature, and i wanted to have more control on the app over some other alternatives.

As a simple user, you can drag'n'drop your obsidian vault, put it on github and host it on Vercel, and you're done. You can now access your notes from anywhere. Yasow has some basic features and some more coming soon.

But if you are a developper, or know a little bit of code, that's where things start to be interesting, you can easily customize the app to fit your needs, and even add some features that you want. I want to keep Yasow quite simple.

Why "Yasow" ? Yet Another Simple Obsidian Website. (Yes i'm very imaginative 🙃)

Features

  • Drag'N'Drop obsidian vault
    • Special characters 100% supported
    • As deep as you want
  • Automatic links [[]] with aliases support
  • Folder navigation
  • Automatic table of content
  • Light and dark theme
  • Customize markdown rendering with react components
  • Full markdown support (even codeblocs with syntax highlighting)
  • Configurable page visibility

Partially supported

  • Page for tags
  • Canvas support

Planned

  • Home.md of Index.md as homepage of the directory
    • If the file dont' exist, a table of content of the childs of the directory
  • Search
  • Emoji as file/folder icon if it's on the name
  • Graph View
  • Password protected page

Contributing

Contributions are what make the open source community. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Don't hesitate to pm me on discord to talk about the app. You can find my tag lower.

License

This project is licensed under the MIT License. You are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, subject to the conditions stated in the license. In all cases, you must include the full MIT License text in any significant portions or distributions of this project.

Contact

logo-discord logo-reddit logo-reddit

Project Setup

Recommended IDE Setup

Install

$ npm run install

Development

$ npm run dev

Open http://localhost:3000 with your browser to see the result.

Disclaimer

This project, Yasow, is an open-source tool developed by the community and is not affiliated with, endorsed by, or associated with Obsidian in any way. All trademarks and copyrights related to Obsidian are the property of their respective owners. This tool is provided as-is with no guarantees or warranties.

Releases

No releases published

Packages

No packages published