Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/marktext/marktext

πŸ“A simple and elegant markdown editor, available for Linux, macOS and Windows.
https://github.com/marktext/marktext

dark-mode editor electron element-ui emoji focus-mode latex linux mac macos markdown marktext next-generation source-code typewriter-mode vue windows

Last synced: 3 days ago
JSON representation

πŸ“A simple and elegant markdown editor, available for Linux, macOS and Windows.

Awesome Lists containing this project

README 

        
MarkText



MarkText





  

    twitter

  





  :high_brightness: Next generation markdown editor :crescent_moon:


  A simple and elegant open-source markdown editor that focused on speed and usability.


  Available for Linux, macOS and Windows.










  

  

    LICENSE

  

  

  

    build

  

  

    build

  

  

  

    total download

  

  

  

    latest download

  

  

  

    sponsors

  






  


    

      Website

    

     | 

    

      Features

    

     | 

    

      Downloads

    

     | 

    

      Development

    

     | 

    

      Contribution

    

  







  Translations:

  

    :cn:

  

  

    :taiwan:

  

  

    :poland:

  

  

    :jp:

  

  

    :fr:

  

  

    :tr:

  

  

    :es:

  

  

    :portugal:

  

  

    :kr:

  






  This Markdown editor that could. Built with ❀︎ by

    Jocs and

    

      contributors

    

    .

  








Supporting MarkText



MarkText is an MIT licensed open source project, and the latest version will always be downloadable for free from the GitHub release page. MarkText is still in development, and its development is inseparable from all sponsors. I hope you join them:



- [Become a backer or sponsor on Patreon](https://www.patreon.com/ranluo) or [One time donation](https://github.com/Jocs/sponsor.me)

- [Become a backer or sponsor on Open Collective](https://opencollective.com/marktext)



##### What's the difference between Patreon and Open Collective?



Patreon: Funds will be directly sponsored to Luo Ran (@jocs) who created MarkText and continues to maintain it.

Open Collective: All expenses are transparent. The funds will be used for the development and maintenance of MarkText, funding online and offline activities, and acquiring other necessary resources.

Names and company logos of all sponsors (from both Patreon and Open Collective) will appear on the official website for MarkText and in its README.md file.



**Special Sponsors**





 




**Platinum Sponsors**





 




**Gold Sponsors**





  




**Silver Sponsors**





  




**Bronze Sponsors**





  




**Backers**





  




## Screenshot



![](docs/marktext.png?raw=true)



## Features



- Realtime preview (WYSIWYG) and a clean and simple interface to get a distraction-free writing experience.

- Support [CommonMark Spec](https://spec.commonmark.org/0.29/), [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) and selective support [Pandoc markdown](https://pandoc.org/MANUAL.html#pandocs-markdown).

- Markdown extensions such as math expressions (KaTeX), front matter and emojis.

- Support paragraphs and inline style shortcuts to improve your writing efficiency.

- Output **HTML** and **PDF** files.

- Various themes: **Cadmium Light**, **Material Dark** etc.

- Various editing modes: **Source Code mode**, **Typewriter mode**, **Focus mode**.

- Paste images directly from clipboard.



:crescent_moon:themes:high_brightness:



| Cadmium Light                                     | Dark                                            |

|:-------------------------------------------------:|:-----------------------------------------------:|

| ![](docs/themeImages/cadmium-light.png?raw=true)  | ![](docs/themeImages/dark.png?raw=true)         |

| Graphite Light                                    | Material Dark                                   |

| ![](docs/themeImages/graphite-light.png?raw=true) | ![](docs/themeImages/materal-dark.png?raw=true) |

| Ulysses Light                                     | One Dark                                        |

| ![](docs/themeImages/ulysses-light.png?raw=true)  | ![](docs/themeImages/one-dark.png?raw=true)     |



:smile_cat:Edit modes:dog:



| Source Code          | Typewriter               | Focus               |

|:--------------------:|:------------------------:|:-------------------:|

| ![](docs/source.gif) | ![](docs/typewriter.gif) | ![](docs/focus.gif) |



## Why make another editor?



1. I love writing. I have used a lot of markdown editors, yet there is still not an editor that can fully meet my needs. I don't like to be disturbed when I write by some unbearable bug. **MarkText** uses virtual DOM to render pages which has the added benefits of being highly efficient and being open source. That way anyone who loves markdown and writing can use MarkText.

2. As mentioned above, **MarkText** is completely free and open source and will be open source forever. We hope that all markdown lovers will contribute their own code and help develop **MarkText** into a popular markdown editor.

3. There are many markdown editors and all have their own merits, some have features which others don't. It's difficult to satisfy each markdown users' needs but we hope **MarkText** will be able to satisfy each markdown user as much as possible. Although the latest **MarkText** is still not perfect, we will try to make it as best as we possibly can.



## Download and Installation



![platform](https://img.shields.io/static/v1.svg?label=Platform&message=Linux-64%20|%20macOS-64%20|%20Win-32%20|%20Win-64&style=for-the-badge)



| ![](https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/screenshots/v1.0.x/mac-pass-sm.png)                                                                                                  | ![](https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/screenshots/v1.0.x/windows-pass-sm.png)                                                                                                          | ![](https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/screenshots/v1.0.x/linux-pass-sm.png)                                                                                                                        |

|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|

| [![latest version](https://img.shields.io/github/downloads/marktext/marktext/latest/marktext-x64.dmg.svg)](https://github.com/marktext/marktext/releases/download/v0.17.1/marktext-x64.dmg) | [![latest version](https://img.shields.io/github/downloads/marktext/marktext/latest/marktext-setup.exe.svg)](https://github.com/marktext/marktext/releases/download/v0.17.1/marktext-setup.exe) | [![latest version](https://img.shields.io/github/downloads/marktext/marktext/latest/marktext-x86_64.AppImage.svg)](https://github.com/marktext/marktext/releases/download/v0.17.1/marktext-x86_64.AppImage) |



Want to see new features of the latest version? Please refer to [CHANGELOG](.github/CHANGELOG.md).



#### macOS



You can either download the latest `marktext-%version%.dmg` from the [release page](https://github.com/marktext/marktext/releases/latest) or install MarkText using [**homebrew cask**](https://github.com/caskroom/homebrew-cask). To use Homebrew-Cask you just need to have [Homebrew](https://brew.sh/) installed.



```bash

brew install --cask mark-text

```



#### Windows



Simply download and install MarkText via setup wizard (`marktext-setup-%version%.exe`) and choose whether to install per-user or machine wide. Alternatively, install MarkText using a package manager such as [Chocolatey](https://chocolatey.org/) or [Winget](https://docs.microsoft.com/en-us/windows/package-manager/winget/).



To use Chocolatey, you need to have [Chocolatey](https://chocolatey.org/install) installed:



```bash

choco install marktext

```



To use Winget, you need to have [Winget](https://docs.microsoft.com/en-us/windows/package-manager/winget/#install-winget) installed:



```bash

winget install marktext

```



#### Linux



Please follow the [Linux installation instructions](docs/LINUX.md).



#### Other



All binaries for Linux, macOS and Windows can be downloaded from the [release page](https://github.com/marktext/marktext/releases/latest). If a version is unavailable for your system, then please open an [issue](https://github.com/marktext/marktext/issues).



## Development



If you wish to build MarkText yourself, please check out our [build instructions](docs/dev/BUILD.md).



- [User documentation](docs/README.md)

- [Developer documentation](docs/dev/README.md)



If you have any questions regarding MarkText, you are welcome to write an issue. When doing so please use the default format found when opening an issue. Of course, if you submit a PR directly, it will be greatly appreciated.



## Integrations



- [Alfred Workflow](http://www.packal.org/workflow/mark-text): A Workflow for the macOS app Alfred: Use "mt" to open files/folder with MarkText.



## Contribution



MarkText is in development, please make sure to read the [Contributing Guide](CONTRIBUTING.md) before making a pull request. Want to add some features to MarkText? Refer to our [roadmap](https://github.com/marktext/marktext/projects?type=classic) and open issues.



## Contributors



Thank you to all the people who have already contributed to MarkText[[contributors](https://github.com/marktext/marktext/graphs/contributors)].



Special thanks to @[Yasujizr](https://github.com/Yasujizr) who designed the MarkText logo.






## License



[**MIT**](LICENSE).



[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmarktext%2Fmarktext.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmarktext%2Fmarktext?ref=badge_large)