Converter – Markdown tekst naar HTML (Windows)
Informatie (ENG):
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.
The overriding design goal for Markdownâs formatting syntax is to make it as readable as possible. The idea is that 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, the single biggest source of inspiration for Markdownâs syntax is the format of plain text email.
The best way to get a feel for Markdownâs formatting syntax is simply to look at a Markdown-formatted document. For example, you can view the Markdown source for the article text on this page here:http://daringfireball.net/projects/markdown/index.text
(You can use this â.textâ suffix trick to view the Markdown source for the content of each of the pages in this section, e.g. the Syntax and Licensepages.)
Markdown is free software, available under a BSD-style open source license. See the License page for more information.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 |
1.0.1 (14 Dec 2004): + Changed the syntax rules for code blocks and spans. Previously, backslash escapes for special Markdown characters were processed everywhere other than within inline HTML tags. Now, the contents of code blocks and spans are no longer processed for backslash escapes. This means that code blocks and spans are now treated literally, with no special rules to worry about regarding backslashes. **NOTE**: This changes the syntax from all previous versions of Markdown. Code blocks and spans involving backslash characters will now generate different output than before. + Tweaked the rules for link definitions so that they must occur within three spaces of the left margin. Thus if you indent a link definition by four spaces or a tab, it will now be a code block. [a]: /url/ "Indented 3 spaces, this is a link def" [b]: /url/ "Indented 4 spaces, this is a code block" **IMPORTANT**: This may affect existing Markdown content if it contains link definitions indented by 4 or more spaces. + Added `>`, `+`, and `-` to the list of backslash-escapable characters. These should have been done when these characters were added as unordered list item markers. + Trailing spaces and tabs following HTML comments and `<hr/>` tags are now ignored. + Inline links using `<` and `>` URL delimiters weren't working: like [this](<http://example.com/>) + Added a bit of tolerance for trailing spaces and tabs after Markdown hr's. + Fixed bug where auto-links were being processed within code spans: like this: `<http://example.com/>` + Sort-of fixed a bug where lines in the middle of hard-wrapped paragraphs, which lines look like the start of a list item, would accidentally trigger the creation of a list. E.g. a paragraph that looked like this: I recommend upgrading to version 8. Oops, now this line is treated as a sub-list. This is fixed for top-level lists, but it can still happen for sub-lists. E.g., the following list item will not be parsed properly: + I recommend upgrading to version 8. Oops, now this line is treated as a sub-list. Given Markdown's list-creation rules, I'm not sure this can be fixed. + Standalone HTML comments are now handled; previously, they'd get wrapped in a spurious `<p>` tag. + Fix for horizontal rules preceded by 2 or 3 spaces. + `<hr>` HTML tags in must occur within three spaces of left margin. (With 4 spaces or a tab, they should be code blocks, but weren't before this fix.) + Capitalized "With" in "Markdown With SmartyPants" for consistency with the same string label in SmartyPants.pl. (This fix is specific to the MT plug-in interface.) + Auto-linked email address can now optionally contain a 'mailto:' protocol. I.e. these are equivalent: <mailto:user@example.com> <user@example.com> + Fixed annoying bug where nested lists would wind up with spurious (and invalid) `<p>` tags. + You can now write empty links: [like this]() and they'll be turned into anchor tags with empty href attributes. This should have worked before, but didn't. + `***this***` and `___this___` are now turned into <strong><em>this</em></strong> Instead of <strong><em>this</strong></em> which isn't valid. (Thanks to Michel Fortin for the fix.) + Added a new substitution in `_EncodeCode()`: s/\$/$/g; This is only for the benefit of Blosxom users, because Blosxom (sometimes?) interpolates Perl scalars in your article bodies. + Fixed problem for links defined with urls that include parens, e.g.: [1]: http://sources.wikipedia.org/wiki/Middle_East_Policy_(Chomsky) "Chomsky" was being erroneously treated as the URL's title. + At some point during 1.0's beta cycle, I changed every sub's argument fetching from this idiom: my $text = shift; to: my $text = shift || return ''; The idea was to keep Markdown from doing any work in a sub if the input was empty. This introduced a bug, though: if the input to any function was the single-character string "0", it would also evaluate as false and return immediately. How silly. Now fixed. 1.0: + Blockquote contents are once again indented by two spaces, and `<pre>` content is special-cased. 1.0fc2: + Disabled the 'use utf8' pragma, which caused crashes for people running Markdown on Perl 5.6.1. + Fixed a couple of bugs in _DoLists() and _ProcessListItems() that caused unordered lists starting with `+` or `-` to be turned into *ordered* lists. + Added to the list of block-level HTML tags: noscript, form, fieldset, iframe, math + Fixed an odd bug where, with input like this: > This line starts the blockquote * This list is part of the quote. * Second item. This paragraph is not part of the blockquote. The trailing paragraph was incorrectly included in the blockquote. (The solution was to add an extra "\n" after lists.) + The contents of `<blockquote>` tags are no longer indented in the HTML output. It made the source look neater, but screwed with any `<pre>` blocks in the blockquote. + When running under MT 3.0 or later, now displays version number in the Markdown info on the main screen. 1.0fc1: + Added some MT 3.0 stuff to register the plug-in in the MT web UI. This should not prevent Markdown from running under MT 2.6. + Greatly simplified the rules for code blocks. No more colons necessary; if it's indented (4 spaces or 1 tab), it's a code block. + Unordered list items can now be denoted by any of the following bullet markers: [*+-] + _DoCodeSpans() now uses a much simpler regex pattern. Thanks to Michel Fortin for the patch. * s/"/"/g to fix literal quotes within title attributes. 1.0b9: * s/"/"/g to fix literal quotes within img alt attributes. 1.0b8: * Tweaked file slurping syntax. * Added 'math' tags to block-level tag patterns in _HashHTMLBlocks(). Please disregard all the 'math'-tag related items in 1.0b7. * Commented out some vestigial code in _EscapeSpecialChars() 1.0b7: * Added 'math' to $tags_to_skip pattern, for MathML users. * Tweaked regex for identifying HTML entities in _EncodeAmpsAndAngles(), so as to allow for the very long entity names used by MathML. (Thanks to Jacques Distler for the patch.) * _DoCodeSpans() now uses 'no strict' inside the ??{} construct in the regex pattern, which (the addition of 'no strict') allows us to use $backtick_count as an undeclared variable. Perl 5.8.4 complains without a 'my' here under 'use strict', but earlier versions of Perl *won't* allow 'my' here. Bizarrely, the opposite is true of 'local', which works fine under Perl 5.6.1 - 5.8.3, but doesn't work under Perl 5.8.4. * All the internal subroutines now return an empty string if called without a text parameter. It's my hope that this will let Markdown.pl work better under Perl 5.6.0. 1.0b6: * <MTMarkdownOptions> is now a container tag. * "raw" mode for plaintext output in MT, using MarkdownOptions container tag: <MTMarkdownOptions output='raw'> ... </MTMarkdownOptions> * Changed name of '--htmltags' CLI switch to '--html4tags' 1.0b5: * If Markdown() is called without a string parameter, it now returns an empty string. Previously, it'd generate warnings. This should never happen, but there's no harm in safeguarding against it. * Workaround for supporting <ins> and <del> as block-level tags. This only works if the start and end tags are on lines by themselves. * Three or more underscores can now be used for horizontal rules. * Lines containing only whitespace are trimmed from blockquotes. * You can now optionally wrap URLs with angle brackets -- like so: `<http://example.com>` -- in link definitions and inline links and images. * `_` and `*` characters in links and images are no longer escaped as HTML entities. Instead, we use the ridiculous but effective MD5 hashing trick that's used to hide these characters elsewhere. The end result is that the HTML output uses the literal `*` and `_` characters, rather than the ugly entities. 1.0b4: Thu 25 Mar 2004 * Fixed bug where a paragraph with multiple inline links or images -- i.e. [links like this](url "title") -- parsed incorrectly. The regex to match title strings was greedy, but shouldn't have been. * Much improved Blosxom interface: no longer processes Blosxom titles; now offers optional integration with meta plug-in, so that one can specify Markdown on a per-post basis. Thanks to Jason Clark <http://jclark.org/weblog/>. * Ampersands in defined links are now encoded as `&` when necessary. E.g., if you define this: [1]: /foo&bar the resulting href attribute will point to "/foo&bar" * Implicit reference ID shortcut is now hooked up for img's: ![alt text][] * Markdown now allows for a newline break between [link text] [id], as in this sentence. (In both links and images.) * Underscores and asterisks within automatic links no longer show up in the output as MD5 hash values. 1.0b3: Fri 12 Mar 2004 * Fixed tiny bug where link and image id references were being treated case sensitively. 1.0b2: Fri 12 Mar 2004 * Fixed bug in code spans where ampersands were getting double-encoded. * Lines with nothing but ">" characters (i.e. blank lines in a blockquote) aren't stripped until we're actually processing blockquotes. This makes it possible to include a line with nothing but a ">" in a code block now. * Fixed a minor parsing glitch with inline HTML blocks which have trailing spaces or tabs after the closing tag. You'd end up with an empty `<p></p>` after the tag. * Markdown now clears its hash table of defined link references at the beginning of each article it processes. This solves a bug where links defined in article A could be "seen" in article B if both both articles appeared on the same page (e.g. an index page that displays the most recent entries). 1.0b1: Tue 9 Mar 2004 Initial public release. |
Gebruik van de binary is als volgt:
markdown.exe readme.md >readme.htm
[#/software/markdown” ]