[Typora](https://typora.io/) is a simple [[Markdown]] editor with customizable themes.
## install Typora
Download the Typora installer from its website and run. If you have a license code already, you can find it in a previous installation under *Preferences > General*. You can install Typora on up to 3 devices.
## launch Typora from shell
To launch Typora from [[Git Bash]], first create a markdown file with `touch` and then open it with `start`. More instructions are available [here](https://support.typora.io/Use-Typora-From-Shell-or-cmd/). If not already done, you will be asked to set the default editor for Markdown files, select Typora, Always.
```bash
touch README.md
start README.md
```
You could also add `typora.exe` in [[PATH]], then use `typora xxx.md` to open markdown file, or create new one if target file does not exists.
## use of images in Typora
Markdown can only store a reference to an image, not the image itself. Whenever I'm working in Markdown, I include images by first uploading them to a cloud hosting service using [[ShareX]]. However, Typora supports various methods for adding images, including drag/drop, markdown syntax, copy/paste. When the image is added in this way, Typora allows for custom upload script to execute to handle storage of the asset.
## install Typora (WSL)
Follow the [instructions](https://support.typora.io/Typora-on-Linux/) in for installing on Linux to use Typora with WSL.
```bash
# Add your key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://downloads.typora.io/typora.gpg | sudo tee /etc/apt/keyrings/typora.gpg > /dev/null
# Add the repo securely
echo "deb [signed-by=/etc/apt/keyrings/typora.gpg] https://downloads.typora.io/linux ./" | sudo tee /etc/apt/sources.list.d/typora.list
sudo apt-get update
# install typora
sudo apt-get install typora
```
To open Typora in the current folder, simply use
```bash
typora . & disown
```
This will open Typora in its own process (so the shell is not waiting for it) and keep Typora open even if the shell is closed. Your terminal will print the process id.