I have created new document and inserted two paragraphs. First paragraph holds text "par2" and second paragraph holds text "par2". Now I execute the following macro (comments explain behavior).



According to documentation "Paragraphs.Add returns a Paragraph object that represents a new, blank paragraph added to a document." What I missed?

The problem with your code is that 'p.Range.Text = "par3"' overwrites the whole of what used to be the final paragraph, including the break. Try 'p.Range.InsertAfter "par3"' to update the new final paragraph or 'p.Range.InsertBefore "par3"' to update the old one (note that this will not delete whatever's already in that paragraph).

__________________
Cheers,
Paul Edstein
[Fmr MS MVP - Word]

@macropod
Thanks for answer, but this Word's object model doesn't fit my mind. It's highly non-intuitive.
I add paragraph with Paragraphs.Add(). Then I have these two options to obtain reference to newly created paragraph: 1) with Set p = .... and 2) Paragraphs(Paragraphs.Count). But in reality they are two different objects! Why?

Word's object model is quite logical, actually. Your code defines a range [via Set p = .Paragraphs.Add()], which can't be outside the range defined by the document's final paragraph break (otherwise it wouldn't be part of the document), so it has to occur before that, then replaces whatever's in that range with something else [via p.Range.Text = "par3"]. You can confirm that's what happening be changing 'p.Range.Text = "par3"' to 'p.Range.Font.ColorIndex = wdRed'. I suspect the problem you're having is a conceptual one, rather than anything to do with Word's object model.

__________________
Cheers,
Paul Edstein
[Fmr MS MVP - Word]

Yes, Paul, you're actually right. I come from Excel environment, and I have difficulty with switching to Word's realm. I felt this since I first tried to write VBA code in Word.
And yes - the main struggle is paragraphs and all manipulating with them. I would like you to help me with this.
So, when I execute Paragraphs.Add(), I see new paragraph mark which happens to be the last one in document. So, this is my paragraph. It has a Range.Text property which can be assigned some text. What I do not understand, why p.Range.Text deletes this brand new paragraph and, moreover, replaces the text of second paragraph?
Look. Paragraphs(Paragraphs.Count) refers to the same paragraph. Then why p.Range.Text fails to work when Paragraphs(3) works fine? Can you explain me more in detail? Thanks beforehand!

That's where your conceptual difficulty is - since you're working with the end of the document your new paragraph is inserted before the final paragraph break. You can't insert one after the final paragraph break. Thus, the one you inserted isn't the last one, but the second-last. As I said in my last post:
When your alternate method of referencing the last paragraph via 'Set p = .Paragraphs(.Paragraphs.Count)' is invoked, that's after you had added the new paragraph (before the final one).

PS If you want to reference the last paragraph, you could also use 'Set p = .Paragraphs.Last'.

__________________
Cheers,
Paul Edstein
[Fmr MS MVP - Word]

A picture is worth a thousand words.