tzaiyang
commented
2 years ago 之前关于Markdown的一些笔记， 可以参考一下
Introduction
Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).
Thus, “Markdown” is two things: (1) a plain text formatting syntax; and (2) a software tool, written in Perl, that converts the plain text formatting to HTML. See the Syntax page for details pertaining to Markdown’s formatting syntax. You can try it out, right now, using the online Dingus.
Philosophy
Markdown is intended to be as easy-to-read and easy-to-write as is feasible.
Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. While Markdown’s syntax has been influenced by several existing text-to-HTML filters — including Setext, atx, Textile, reStructuredText, Grutatext, and EtText — the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.
To this end, Markdown’s syntax is comprised entirely of punctuation characters, which punctuation characters have been carefully chosen so as to look like what they mean. E.g., asterisks around a word actually look like emphasis. Markdown lists look like, well, lists. Even blockquotes look like quoted passages of text, assuming you’ve ever used email.
Language
Extend markdown:
GFM, GitHub Flavored Markdown
Rmarkdown: https://rmarkdown.rstudio.com/authoring_quick_tour.html
Kramdown, a Markdown superset, GitHub Pages supports two Markdown processors: kramdown and GitHub's own extended CommonMark processor, which is used to render GitHub Flavored Markdown throughout GitHub. For more information, see "About writing and formatting on GitHub."
HTML
Parser
Choosing a version
There's a lot to consider when thinking about implementing Markdown into a project, including the language you'll be developing with as well as the features you want to support. The original implementation was written in Perl, but that's not a practical option for every project. There are implementations in most popular languages including: PHP, Ruby and JavaScript. Which language you choose will have repercussions as to which features you'll be able to support and what libraries will be available. Let's take a look at some of the options:
| Language | Library (download project) |
|---|---|
| Perl | Original version |
| JavaScript | CommonMark, Marked, Markdown-it, Remarkable, Showdown, Stackedit |
| Ruby | Github Flavored Markup, Kramdown, Maruku, Redcarpet |
| PHP | Cebe Markdown, Ciconia, Parsedown, PHP Markdown Extended |
| Python | Python Markdown |
There are additional implementations in many other languages, just in case you're looking to implement Markdown in other languages.
YinDongFang
参考/学习目标库：