https://github.com/flecart/obsidown

Convert obsidian files into well linked markdowns
https://github.com/flecart/obsidown

jekyll markdown obsidian obsidian-md

Last synced: about 1 month ago
JSON representation

Convert obsidian files into well linked markdowns

• Host: GitHub
• URL: https://github.com/flecart/obsidown
• Owner: Flecart
• License: gpl-3.0
• Created: 2024-03-10T14:23:10.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-09-29T15:48:13.000Z (about 2 months ago)
• Last Synced: 2024-10-01T09:41:43.122Z (about 1 month ago)
• Topics: jekyll, markdown, obsidian, obsidian-md
• Language: Python
• Homepage: https://pypi.org/project/obsidown/
• Size: 110 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ObsiDown

Convert obsidian files into well linked markdowns!

## Example use cases

- Export Obsidian subdirectories while maintaining the links in markdown format

- Make obsidian math Kramdown-compatible

- Use obsidian to write for Jekyll web pages. 

## How to use

Define a configuration file `config.yaml`. In the repo it is provided one as example.

Install the `poetry` dependencies and then you just need to run `poetry run python -m obsidown --config path/to/config.yaml`

It's possible to install from `pypi` index by `pip install obsidown`.

Then you can run it with `python -m obsidown`

## Feedback

This project is a hobby project used to automate some things I use myself. Currently it is a early early project!

If you need additional features or report some issues or need help, feel free to open a new issue.

## Documentation

The quickest way to check what is the format of the config file is to see the pydantic from `config.py`.

Here I will just outline it briefly.

- `sources` defines where to look for the input files.

  - `paths`: where to look for the md files?

  - `images`: where to look for the linked images?

- `output` defines where to write the exported files.

  - `base`: defines the base url for links

  - `path`: defines a subpath for the markdown files

  - `images`: defines a subpath for the image fiiles

  - `filesystem`: where to write

- `pipeline`: defines the single operations possible on a markdown file.

  - `name`: the identifier of the operation, you should check `dispatch.py` for a list of the operations.

  - `options`: variable options of the single operation.