[DG: Open Forum] Favorite Markup Language

[Aaron Zeckoski]

rst2 is probably the frontrunner for me these days.
:-)
-AZ


On Mon, Apr 26, 2010 at 9:09 PM, Steven Githens <swgithen at mtu.edu> wrote:
> Aaron Zeckoski wrote:
>>
>> I am not a fan of the way markdown handles URLs. Most of the other
>> plain text systems will allow you to simply place the URL in and will
>> turn it into a link automatically. Markdown is one of the ones that
>> requires the syntax which puts all the links at the end of the
>> document or inline with a bunch of quotes and things around it. I
>> don't like that because it is not very readable in plain text when you
>> have a document with lots of URLs in it.
>>
>>
>
> Which system(s) do you like the best (or dislike the least :p ) that
> transparently handle URL's?
>
> -s
>
>> -AZ
>>
>>
>> On Mon, Apr 26, 2010 at 8:28 PM, Steven Githens <swgithen at mtu.edu> wrote:
>>
>>>
>>> I'm in love already.... ;)
>>>
>>> Thanks for the testimonial, this is what I've been leading towards with
>>> just a little research among the different programming cultures I run in
>>> to ( I brought this up last week at our Indianapolis Python Meetup too,
>>> where Markdown(2) also seemed to win (at least by the most vocal people)
>>> ).
>>>
>>> Apparently there is a markdown2 which has some extra stuff that original
>>> markdown doesn't to?
>>>
>>> One other thing, and this is in response to Chuck's LaTeX note too, is
>>> that I think there is a markdown implementation in most heavy use
>>> programming languages.
>>>
>>> While I've enjoyed LaTeX, I *think* there is only a C implementation of
>>> it. I really want something that be run as part of anyones build
>>> processes. Things like Restructured Text come closer since it's Python
>>> based, ( and there are high
>>> quality Python implementations for both JVM and .NET machines), but
>>> Markdown processors are all over the place.
>>>
>>> I think I am going to look closer at Markdown now. ( this whole thing
>>> came up because I was hacking on Bespin code, and their docs are done in
>>> Markdown ).
>>>
>>> I am looking forward to hearing back from Chuck on his LyX experience.
>>>
>>> Cheers to the Max,
>>> Steve
>>>
>>> Zach A. Thomas wrote:
>>>
>>>>
>>>> Markdown, A Love Story
>>>> ======================
>>>>
>>>> I love Markdown, though I've never looked at Restructured Text. The
>>>> beauty of Markdown is that it is just as human readable as it is machine
>>>> readable, since it follows the conventions that people _already_ use for
>>>> formatting plain text.
>>>>
>>>>    10 PRINT "You just indent to indicate you want to format as code."
>>>>
>>>> Here are a few other things to love about Markdown:
>>>>
>>>> 1. My [editor of choice][1] syntax-colors my Markdown, and converts the
>>>> document to HTML with a single keyboard shortcut.
>>>> 2. github.com will automatically format as HTML any README file written
>>>> in Markdown.
>>>> 3. "Proper" quotation marks -- and dashes for that matter -- are done
>>>> automatically.
>>>> 4. It's perfect for documents that don't have steep formatting
>>>> requirements.
>>>> 5. You just write, and the syntax gets out of your way.
>>>>
>>>> I'm sure you realize by now that this message is in Markdown. Give it a
>>>> [try!][2]
>>>>
>>>> Zach
>>>>
>>>> -------------------------------------------------
>>>>
>>>> [1]: http://macromates.com/ "TextMate"
>>>> [2]: http://daringfireball.net/projects/markdown/syntax "Markdown
>>>> Syntax"
>>>>
>>>>
>>>> On Apr 26, 2010, at 12:42 PM, Steven Githens wrote:
>>>>
>>>>
>>>>
>>>>>
>>>>> Sometimes I don't mind writing HTML for simple docs ( I used to use
>>>>> docbook, and that was way more painful ).  But I suppose HTML can mean
>>>>> a
>>>>> lot of things.  If you were going to roll a set of documentation with
>>>>> just HTML what stack of tools would you use?  I think the usage of even
>>>>> more than a couple HTML editors would mangle the documents with their
>>>>> own conventions.
>>>>>
>>>>> Usually, if you use Markdown or Restructured Text, in addition to the
>>>>> syntax it brings along the toolchain ( for example using Sphinx with
>>>>> Restructured Text ).  So I guess, it's a core markup plus a set of nice
>>>>> tools to make tables of contents and stuff too, although for this use
>>>>> case I was imagining a text editor being the authoring tool across the
>>>>> examples.
>>>>>
>>>>> -s
>>>>>
>>>>>
>>>>> Nate Angell wrote:
>>>>>
>>>>>
>>>>>>
>>>>>> I like this markup syntax called "HTML"...it's pretty widely used and
>>>>>> there are some tools out there to help you use it.
>>>>>>
>>>>>> --
>>>>>> Nate Angell
>>>>>> Client Evangelist
>>>>>>
>>>>>> On Mon, Apr 26, 2010 at 10:15 AM, Steven Githens <swgithen at mtu.edu>
>>>>>> wrote:
>>>>>>
>>>>>>
>>>>>>
>>>>>>>
>>>>>>> Hi all,
>>>>>>>
>>>>>>> Just curious what you're favorite markup/wiki/formatting syntax is.
>>>>>>> Markdown? Creole? Restructured Text? LaTeX?  Something else?  The
>>>>>>> context here is mostly for writing instructions and technical
>>>>>>> documentation for open source software.
>>>>>>>
>>>>>>> I've been using Restructured Text for my personal projects, and am
>>>>>>> thinking about switching to Markdown or something similar.
>>>>>>>
>>>>>>> DISCUSS!
>>>>>>>
>>>>>>> Cheers,
>>>>>>> Steve
>>>>>>>
>>>>>>>
>>>>
>>>> _______________________________________________
>>>> openforum mailing list
>>>> openforum at collab.sakaiproject.org
>>>> http://collab.sakaiproject.org/mailman/listinfo/openforum
>>>>
>>>> TO UNSUBSCRIBE: send email to
>>>> openforum-unsubscribe at collab.sakaiproject.org with a subject of
>>>> "unsubscribe"
>>>>
>>>>
>>>
>>> _______________________________________________
>>> openforum mailing list
>>> openforum at collab.sakaiproject.org
>>> http://collab.sakaiproject.org/mailman/listinfo/openforum
>>>
>>> TO UNSUBSCRIBE: send email to
>>> openforum-unsubscribe at collab.sakaiproject.org with a subject of
>>> "unsubscribe"
>>>
>>>
>>
>>
>>
>>
>
>



-- 
Aaron Zeckoski - Software Engineer - http://tinyurl.com/azprofile