![]() Note that in monospaced text, multiple spaces are notĬollapsed, but are preserved however, flow and wrapping do occur, andĪny number of spaces may be replaced by a line break. Themselves), although in some contexts, code syntax highlighting may beĪpplied. No bold or italic is possible within it (asterisks just represent Monospaced text is marked with two backquotes "``" instead of asterisks Represent bold italics in reStructuredText). Rare cases where Markdown is more powerful, as there is no way to Nesting bold and italic, reStructuredText does not (this is one of the The asterisks and the text being emphasized. Must be whitespace or other punctuation before the leading asterisks,Īnd after the trailing ones furthermore there must be no space between Italics are marked with one asterisk ( *) and bold face with two. Specifying font faces, one of which is also used by reStructuredText: Text may be used to highlight program or function names, or for veryĪs with many types of formatting, Markdown provides multiple ways of Italic or bold (depending on the font, italics are often rendered Within paragraphs, inline markup provides basic formatting to addĮmphasis to particular words or phrases, most commonly by making them ![]() You may want to use multiple blank lines at the end of a section. Similarly, multiple blank lines are treated just like one blank line (or not) if that is useful for your text editor - I'm looking at you,Įmacs - since multiple spaces are treated the same as a single space. Text when you edit it later, to limit the number of "insignificantĬhanges" in your version control system (you are using one, right?!).įeel free to use two spaces after the period at the end of a sentence When writing text, you should try to wrap source lines to 72Ĭharacters - but only when initially entering them - avoid re-wrapping Significant to both Markdown and reStructuredText, but in different Paragraph or just the first line) for normal text, as indentation is Be sure to avoid initial indentation (either of an entire The basics of text formatting are common to both, a blank line (it mayĬontain spaces or tabs, but nothing else) is used to separate paragraphsĪnd everything within a paragraph "flows" and is wrapped to the display ReStructuredText at all - at least, once you get Haskell and Pandoc Supported by Pandoc adds enough functionality that you don't need to use (In fact, you may find the extended Markdown Into reStructuredText - the online converter at Want to limit yourself to the (admittedly very limited) intersection ofįunctionality in the subset, you can use Pandoc to convert Markdown If you have already used Markdown-specific syntax, or you just don't Here is that the resulting source is more likely to be parsed the same wayīy different Markdown processors, which may handle some details like ![]() Subset wherever possible allows for painless cut & paste between them.Īnother advantage of restricting yourself to the common subset described Use features that are specific to one or the other, using the common Languages (largely from Setext, which inspired both of them) for yourĭocuments, you can eliminate the need for conversion. To avoid having toĬonvert all of your Markdown formatting when that happens, use this GistĪs a guide to the markup syntax common to Markdown and reStructuredText.īy using only the common subset shared by these two lightweight markup ![]() But as you add more sections and features, you mayĭecide that you want the power of reStructuredText. Python doc comments, for which purpose reStructuredText was originallyĭeveloped) you will probably choose to use Markdown for a small document Unless you are embedding text into a programming language (especially Things like automatic generation of tables of contents. With native support (not just embedded HTML) for tables, as well as On the other hand, reStructuredText is more extensible and powerful, Use, and is often preferred when the purpose is simply to generate HTML. Markdown is sometimes considered easier to The most popular ones (generally, not just at GitHub) are MarkdownĪnd reStructuredText. GitHub supports several lightweight markup languages for documentation ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |