LinuxQuestions.org

LinuxQuestions.org (/questions/)
-   Linux - Software (https://www.linuxquestions.org/questions/linux-software-2/)
-   -   Markdown file standard specification manual ? (https://www.linuxquestions.org/questions/linux-software-2/markdown-file-standard-specification-manual-4175605811/)

Xeratul 05-12-2017 08:42 PM

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 ...


Doug G 05-12-2017 08:57 PM

Take a look here: https://daringfireball.net/projects/markdown/syntax

Xeratul 05-12-2017 08:58 PM

Quote:

Originally Posted by Doug G (Post 5709879)

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

ondoho 05-13-2017 03:46 AM

Quote:

Originally Posted by Xeratul (Post 5709880)
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.

Xeratul 05-18-2017 12:37 AM

Quote:

Originally Posted by ondoho (Post 5709977)
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?

Doug G 05-18-2017 05:21 PM

You might review this: https://en.wikipedia.org/wiki/Markdown

Xeratul 05-18-2017 11:08 PM

Quote:

Originally Posted by Doug G (Post 5712573)

https://en.wikipedia.org/wiki/Markdown
ok, I reread, but why '#' ??

ondoho 05-19-2017 10:37 AM

why not?
:rolleyes:

Xeratul 05-19-2017 11:21 AM

Quote:

Originally Posted by ondoho (Post 5712796)
why not?
:rolleyes:

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 '#'.

ondoho 05-19-2017 12:37 PM

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.

Xeratul 05-19-2017 12:59 PM

Quote:

Originally Posted by ondoho (Post 5712860)
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 ...

astrogeek 05-19-2017 01:09 PM

Quote:

Originally Posted by Xeratul (Post 5712867)
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.

Doug G 05-20-2017 01:38 AM

Quote:

Originally Posted by Xeratul (Post 5712658)
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.

Xeratul 05-20-2017 03:53 AM

Quote:

Originally Posted by ondoho (Post 5712860)
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.


All times are GMT -5. The time now is 03:05 AM.