LinuxQuestions.org
Download your favorite Linux distribution at LQ ISO.
Go Back   LinuxQuestions.org > Forums > Linux Forums > Linux - Software
User Name
Password
Linux - Software This forum is for Software issues.
Having a problem installing a new program? Want to know which application is best for the job? Post your question in this forum.

Notices


Reply
  Search this Thread
Old 05-12-2017, 08:42 PM   #1
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Rep: Reputation: 213Reputation: 213Reputation: 213
Markdown file standard specification manual ?


Hello,

I would like to ask if you may know a possible Markdown file standard specification manual.

Code:
Markdown
========

File Specs
----------

> why 
> does
> Markdown
> exist?

and so on ...
 
Old 05-12-2017, 08:57 PM   #2
Doug G
Member
 
Registered: Jul 2013
Posts: 749

Rep: Reputation: Disabled
Take a look here: https://daringfireball.net/projects/markdown/syntax
 
1 members found this post helpful.
Old 05-12-2017, 08:58 PM   #3
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Original Poster
Rep: Reputation: 213Reputation: 213Reputation: 213
Quote:
Originally Posted by Doug G View Post
Is that the official?

So one guy got an idea in his kitchen, and everyone use it?
(I fairly respect the work of JOHN GRUBER. The idea is good)
I think that # could have been used rather for comments.

Is there anything for references?
Maybe Markdown would work too with references (bib?)
Ex: https://pastebin.com/raw/TLCkD1vZ

Last edited by Xeratul; 05-12-2017 at 09:35 PM.
 
Old 05-13-2017, 03:46 AM   #4
ondoho
LQ Addict
 
Registered: Dec 2013
Posts: 17,263
Blog Entries: 10

Rep: Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161
Quote:
Originally Posted by Xeratul View Post
So one guy got an idea in his kitchen, and everyone use it?
exactly.
Quote:
I think that # could have been used rather for comments.
then you are missing the point of markdown.
 
Old 05-18-2017, 12:37 AM   #5
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Original Poster
Rep: Reputation: 213Reputation: 213Reputation: 213
Quote:
Originally Posted by ondoho View Post
you are missing the point of markdown.
Hi,

Maybe, hopefully actually, because for me, the chars '#' could be easy interpreted as a comment, when one uses extensively "sh".

Why not using another char, like the equal '=' for example?
 
Old 05-18-2017, 05:21 PM   #6
Doug G
Member
 
Registered: Jul 2013
Posts: 749

Rep: Reputation: Disabled
You might review this: https://en.wikipedia.org/wiki/Markdown
 
Old 05-18-2017, 11:08 PM   #7
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Original Poster
Rep: Reputation: 213Reputation: 213Reputation: 213
Quote:
Originally Posted by Doug G View Post
https://en.wikipedia.org/wiki/Markdown
ok, I reread, but why '#' ??
 
Old 05-19-2017, 10:37 AM   #8
ondoho
LQ Addict
 
Registered: Dec 2013
Posts: 17,263
Blog Entries: 10

Rep: Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161
why not?
 
Old 05-19-2017, 11:21 AM   #9
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Original Poster
Rep: Reputation: 213Reputation: 213Reputation: 213
Quote:
Originally Posted by ondoho View Post
why not?
Code:
## Sub-heading
vim ""
TeX %%
Bash ##
VB ''
C //
and markdown #

A ms-windows user may think that '#' is cool for h(x)/section(s). Usually, many linux configs are using '#'.
 
Old 05-19-2017, 12:37 PM   #10
ondoho
LQ Addict
 
Registered: Dec 2013
Posts: 17,263
Blog Entries: 10

Rep: Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161Reputation: 5161
markdown is NOT a config file.
it is NOT a script.
markdown files are plain text documents - with additional formatting syntax that is (and this is essential to markdown) easy to read even if you don't convert it to anything.
 
Old 05-19-2017, 12:59 PM   #11
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Original Poster
Rep: Reputation: 213Reputation: 213Reputation: 213
Quote:
Originally Posted by ondoho View Post
markdown is NOT a config file.
it is NOT a script.
markdown files are plain text documents - with additional formatting syntax that is (and this is essential to markdown) easy to read even if you don't convert it to anything.
maybe there could be more markdown format/synstaxs like that ...
 
Old 05-19-2017, 01:09 PM   #12
astrogeek
Moderator
 
Registered: Oct 2008
Distribution: Slackware [64]-X.{0|1|2|37|-current} ::12<=X<=14, FreeBSD_12{.0|.1}
Posts: 5,620
Blog Entries: 11

Rep: Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657Reputation: 3657
Quote:
Originally Posted by Xeratul View Post
maybe there could be more markdown format/synstaxs like that ...
There are quite a few.

My personal favorite is not in wide use as far as I can tell - Textile.

I originally stumbled across it 10-12 years ago when it was the markup used by the TextPattern CMS. I believe TextPattern now uses their own.

I never made much actual use of TextPattern, but pulled out the Textile parser and wrote several web applications using Textile as the markup language - really good solution! I find Textile a more complete markup, and easy for me to remember.
 
Old 05-20-2017, 01:38 AM   #13
Doug G
Member
 
Registered: Jul 2013
Posts: 749

Rep: Reputation: Disabled
Quote:
Originally Posted by Xeratul View Post
https://en.wikipedia.org/wiki/Markdown
ok, I reread, but why '#' ??
Possibly because you seem confused about what markdown is and it's purpose. Markdown was created as a syntax to easily generate html. If you visit github, for example, most project readme files are "readme.md" since markdown (in it's various flavors) is commonly used to generate html

Markdown isn't an editor, or a scripting environment.
 
Old 05-20-2017, 03:53 AM   #14
Xeratul
Senior Member
 
Registered: Jun 2006
Location: UNIX
Distribution: FreeBSD
Posts: 2,357

Original Poster
Rep: Reputation: 213Reputation: 213Reputation: 213
Quote:
Originally Posted by ondoho View Post
markdown is NOT a config file.
it is NOT a script.
markdown files are plain text documents - with additional formatting syntax that is (and this is essential to markdown) easy to read even if you don't convert it to anything.
So, it is then, what's the point to use it on GIThub ... ?


TextPattern CMS.
Textile.

What's the point?

It simply proves that HTML was not a good idea... since people find it too complex.

XML is everywhere and makes not point for a C programmer.

Last edited by Xeratul; 05-20-2017 at 03:55 AM.
 
  


Reply


Thread Tools Search this Thread
Search this Thread:

Advanced Search

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is Off
HTML code is Off



Similar Threads
Thread Thread Starter Forum Replies Last Post
LXer: Markdown may be defined as a standard LXer Syndicated Linux News 0 10-30-2012 07:00 PM
blink file specification rustaee Linux - Newbie 2 10-02-2012 06:31 AM
Kde Control panel not standard in Pardus. Launch Feedback Manual, how? Normal Linux - Desktop 1 01-16-2007 10:13 PM
SMTP - Sockets / Specification file Ellops Programming 6 05-05-2006 03:19 AM

LinuxQuestions.org > Forums > Linux Forums > Linux - Software

All times are GMT -5. The time now is 10:44 PM.

Main Menu
Advertisement
My LQ
Write for LQ
LinuxQuestions.org is looking for people interested in writing Editorials, Articles, Reviews, and more. If you'd like to contribute content, let us know.
Main Menu
Syndicate
RSS1  Latest Threads
RSS1  LQ News
Twitter: @linuxquestions
Open Source Consulting | Domain Registration