Citing the author of a blockquote using Markdown syntax
Asked Answered
C

7

227

I am using the Symfony CMS and it uses Markdown for article writing. I need to do a blockquote of a quote from Benjamin Franklin and would like to have the quote followed by a citation beneath it, but right now all it does is blockquote the whole line. How does one do this in markdown syntax?

Cassella answered 4/1, 2010 at 20:45 Comment(1)
I was hopiing the answer would something that change: ``` @inproceedings{zhou2019objects, title={Objects as Points}, author={Zhou, Xingyi and Wang, Dequan and Kr{\"a}henb{\"u}hl, Philipp}, booktitle={arXiv preprint arXiv:1904.07850}, year={2019} } ``` To APA or IEEE inline citation + bibliography. I wish .... but this is not Latex apparentlyRattlehead
F
283

Markdown has no dedicated citation syntax.

Your best bet is something like this:

> Quote here.
>
> -- <cite>Benjamin Franklin</cite>

which results in:

Quote here.

-- Benjamin Franklin

Fy answered 4/1, 2010 at 20:51 Comment(10)
I would use an &mdash; instead of two hyphens.Demetrius
@Demetrius Style is entirely up to the user. My Markdown install includes Smartypants, which turns -- into an emdash.Fy
Cite is incorrect for marking person's name. dev.w3.org/html5/spec/single-page.html#the-cite-elementRequire
@Paul This is a situation where I'm perfectly happy to ignore their recommendations. Given that spoken speeches, not just publications, can be typically cited in an academic work, I'm comfortable calling that a citation on the web too.Fy
Stating only the author doesn't seem to be incorrect usage according to this document: w3.org/html/wg/drafts/html/master/… I quote: The cite element represents a reference to a creative work. It must include the title of the work or the name of the author(person, people or organization) or an URL reference, or a reference in abbreviated form as per the conventions used for the addition of citation metadata.Merrill
@Zelphir My primary answer would be "who cares?" My secondary answer would be that author-only seems fine from that wording, given that everything's joined by or not and. Title or author or URL or an abbreviated reference.Fy
@Fy Haha, yes I also thought about the or connections there and decided to interpret them in that way :D I think I read that phrase three times or soMerrill
Using inline html is against good markdown rules: MD033/no-inline-html: Inline HTML [Element: cite] markdownlint MD033Leviticus
@Leviticus Follow whatever rules you like. Not citing sources semantically with the cite tag is against good writing rules.Fy
@Fy I see what you mean but I don't see how it's "semantically" wrong. Also please note that a lot of apps or even webapps do not parse HTML tags due to security concerns. So I'm just wondering what's the best rule/procedure to follow here. There's no single authority who has solved these kinds of concerns for us unfortunately.Leviticus
B
125
> The secret to creativity is knowing how to hide your sources. 
> -- <cite>[Albert Einstein][1]</cite>

[1]: http://www.quotedb.com/quotes/2112

If you have a style manual, use its guidelines to determine exactly where to place the citation, etc.

Output of Markdown + Smartypants for the above is

The secret to creativity is knowing how to hide your sources. -- Albert Einstein

Blaze answered 26/1, 2011 at 22:10 Comment(4)
"I would use an &mdash; instead of two hyphens.", -- @Evan, https://mcmap.net/q/117790/-citing-the-author-of-a-blockquote-using-markdown-syntax#comment1923634_2002150.Dynamics
To push the citation to a newline add 2 spaces at the end of the preceding line e.g in the above add 2 spaces after "sources.".Dynamics
"Smartypants" is a heavily overloaded term. What is it in this context? Some JavaScript library? Do you have a reference to it (respond by editing your answer, not here in comment)?Sync
@PeterMortensen I think he's referring to Albert Einstein, but I could be wrong.Lugworm
A
35
> Quote

— Benjamin Franklin

According to the HTML Living Standard, attribution for the quotation must be placed outside the blockquote element.

Attribution for the quotation, if any, must be placed outside the blockquote element.

HTML Standard: 4.4.4. The blockquote element

Note that the cite element represents the title of the work and must not be used to mark up people's names. For more detail check out HTML Standard: 4.5.6 The cite element.

Instead of the hyphen, it is common to use the em dash (U+2014). Many Markdown parsers support Unicode, which means you can write the em dash directly, instead of using HTML entities. Writing such characters directly improves readability, more tools will know what you want and not panic, and your document might be more portable as you are not bounding yourself to HTML.

Astrid answered 6/1, 2021 at 15:25 Comment(1)
You used the HTML standard for markdown here? I think that is a pretty neat idea! I guess there is no living markdown standard, right? And thanks for the links.Lima
D
7

Adding another sample here for reference. Generated from https://en.wikipedia.org/wiki/Special:CiteThisPage

> Test-driven development (TDD) is a software development process that relies on the repetition of a very short development cycle: requirements are turned into very specific test cases, then the software is improved to pass the new tests, only. 
>
> --- [Test-driven development. (2016, November 20). In Wikipedia, The Free Encyclopedia. Retrieved 23:45, November 20, 2016](https://en.wikipedia.org/w/index.php?title=Test-driven_development&oldid=750634597)

Produces the following:

Test-driven development (TDD) is a software development process that relies on the repetition of a very short development cycle: requirements are turned into very specific test cases, then the software is improved to pass the new tests, only.

--- Test-driven development. (2016, November 20). In Wikipedia, The Free Encyclopedia. Retrieved 23:45, November 20, 2016

Denomination answered 7/12, 2016 at 18:44 Comment(0)
D
5

Every pure markdown answer on this page adds a line between the quote and the citation:

Which looks something like this.

— 0x263a

Or they do:

Something like this. — 0x263a

But if you don't want that extra newline and you want the citation to appear on a separate line from the quote:

"Like this."
— 0x263a

You can add a \ to the end of your quote.

> "Quote."\
> — <cite>Author<cite>
Dionne answered 29/6, 2022 at 14:17 Comment(0)
F
2

1. Since any quote it is suppose to have a source, even if it is unknown.

2. Since a markdown > Quote is rendered as <blockquote><p>Quote</p></blockquote> and

> Quote1
>
> Quote2

is rendered as

<blockquote>
  <p>Quote1</p>
  <p>Quote2</p>
</blockquote>

My solution to this is always take the last <p></p> as source and handle it by css (in my case SCSS):

blockquote {
    p {
        display: inline;

        &:first-of-type {
            quotes: '\201C' '\201D' '\2018' '\2019';

            &::before {
                content: open-quote;
                margin-right: 0.1rem;
            }
        }

        &:last-of-type {
            quotes: '\201C' '\201D' '\2018' '\2019';
            font-style: italic;

            &::before {
                content: close-quote "\000A" "\2014" " ";
                white-space: pre;
                margin-left: 0.1rem;
                font-style: normal;
            }
        }

        // In case of a quote without a source.
        &:only-of-type {
            font-style: normal;
            quotes: '\201C' '\201D' '\2018' '\2019';

            &::before {
               content: open-quote;
               margin-right: 0.1rem;
            }

            &::after {
                content: close-quote;
                margin-left: 0.1rem;
            }
        }
    }
}

The \000A it the new line unicode character css format, it help to make the source in appear in the next line, if you don't want, just remove it and add some spaces there. The others are also unicode character css format.

Foothold answered 28/4, 2019 at 21:1 Comment(0)
D
-1

Personally I prefer nesting a blockquote in a blockquote.

Here is how I like doing it:

> Quote here.
>
>> <cite>Benjamin Franklin</cite>

The output varies on how you style everything, but using plain `ol github look like this, which I personally think looks great!

enter image description here

https://gist.github.com/nahtnam/63e3a14acd0f02313ec0

Drapery answered 4/8, 2014 at 5:58 Comment(1)
Though this looks nice in a Markdown previewer, this is not semantically correct.Jaleesa

© 2022 - 2024 — McMap. All rights reserved.