Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kinten108101/markdoc

Personal notes and writings
https://github.com/kinten108101/markdoc

documentation markdown notes

Last synced: about 2 months ago
JSON representation

Personal notes and writings

Awesome Lists containing this project

README

        

# MarkDoc

A distributed system of note repositories / Zettelkästen, where I store my personal notes and writings and more.

You should read up on the definition of a Zettelkasten[^zet] and a brief history of the MarkDoc system[^varzet].

## Repositories

These repositories are (in chronological order):

- Joplin: A Joplin repository with Dropbox backend managed by [email protected] (Linked with Dropbox);
- BlackMountain: A Trello repository managed by [email protected] (Linked with Atlassian);
- markdoc: Markdown files on local machine managed by kinten@Archio;
- engineeringWiki: An Obsidian repository managed by kinten@Archio;
- Gia Bảo's Notion: A Notion repository managed by [email protected] (Linked with Google Account);
- Blobbook 0: A Le Hong Phong notebook;
- Blobbook 1: A Lazada notebook;
- Blobbook 2: A VNG notebook;
- Blobbook 3: A Blue Angel notebook;
- MarkDoc: A Bundled Notes repository managed by [email protected] (Linked with Google Account);

Disconnected repositories:

- Firefly: A OneNote repository;
- Evernote;
- Bear;
- Werdsmith;
- Drafts;
- Google Keep;
- Simple Notes;
- Standard Notes;
- and many more lost to time...

## Naming system

MarkDoc uses a naming scheme that closely resembles the URI system with a `markdoc` protocol.

Or you can use the EBNF form below for the absolute path:

```
repository = 'engineeringWiki' | '"Gia Bảo's Notion"' | ...
item = ( 'markdoc:///' )? repository '/' (collection '/')* item '#' section
```

Some other rules:

- If item is a file, do not include file extension;
- Relative path is possible and is encouraged.

For example, to refer to the "In Future" section in the "Various Zettelkästen" article in the engineeringWiki repository, write `engineeringWiki/Various Zettelkästen#In Future`

[^zet]: https://en.wikipedia.org/wiki/Zettelkasten
[^varzet]: markdoc:///engineeringWiki/Various Zettelkästen